Skip to main content
GET
/
v1
/
places
/
details
Get Place Details
curl --request GET \
  --url https://api.bookovia.com/v1/places/details \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "place": {
    "id": "<string>",
    "name": "<string>",
    "category": "<string>",
    "latitude": 123,
    "longitude": 123,
    "address": "<string>",
    "brand": "<string>",
    "h3_cell": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.bookovia.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Place Details endpoint returns all available information for a single place including name, category, coordinates, address, contact information, and brand details.

​
Authentication

This endpoint requires authentication via API key in the X-API-Key header. Required permissions: geocoding:read

​
Request

​
id
string
required
Place identifier (Overture GERS ID)Obtained from Places Search or Places Nearby responses

​
Request Example

curl -X GET "https://api.bookovia.com/v1/places/details?id=018a9083-401f-4207-b450-c8ff39626513" \
  -H "X-API-Key: bkv_test_your_api_key_here"

​
Response

​
success
boolean
Indicates whether the request was successful
​
place
object
Complete place information

​
Response Example

{
  "success": true,
  "place": {
    "id": "018a9083-401f-4207-b450-c8ff39626513",
    "name": "Starbucks",
    "category": "coffee_shop",
    "latitude": 40.7128,
    "longitude": -74.0060,
    "address": "123 Broadway, New York, NY 10001",
    "brand": "Starbucks",
    "h3_cell": "8928308280fffff"
  }
}

​
Error Handling

Status CodeErrorDescription
400id parameter is requiredMissing place ID
404place not foundNo place exists with this ID
401API key requiredMissing authentication

​
Performance

  • Average Response Time: <50ms
  • Cache TTL: 24 hours (place data changes infrequently)