Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

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

Searches for places using Mapbox’s suggestion API. Returns a list of matching locations with basic information.

Endpoint

GET /api/v1/places

Parameters

query
string
required
The search query for finding places. Must contain at least one alphanumeric character.
curl -X GET https://api.onlydrams.app/api/v1/places?query=whiskey%20bar \
  -H "Authorization: Bearer $ACCESS_TOKEN"
curl -X GET https://api.onlydrams.app/api/v1/places?query=123%20Main%20St \
  -H "Authorization: Bearer $ACCESS_TOKEN"
[
  {
    "id": "poi.123456789",
    "name": "Whiskey Bar & Grill",
    "address": "123 Main Street, New York, NY 10001"
  },
  {
    "id": "poi.987654321",
    "name": "The Bourbon Room",
    "address": "456 Oak Avenue, New York, NY 10002"
  },
  {
    "id": "poi.555666777",
    "name": "Scotch & Soda",
    "address": "789 Pine Street, New York, NY 10003"
  }
]
[]
[]

Error Responses

{
  "error": "Query parameter is required"
}