Places

Search places

Build a list of businesses and locations. Pass a query for text search, or a location (and optional type) for nearby search. Page text-search results with the returned cursor.

POST

/api/v1/places/search

Request bodyrequired

queryoptional

string

Free-text query, e.g. "dentists in Munich". Required unless `location` is set.

locationoptional

object

Center point. Required unless `query` is set. Without a query this is a nearby search inside the radius.

latituderequired

number

longituderequired

number

radiusMetersoptional

integer

Radius when `location` is set. Defaults to 50 km. Nearby search stays inside this circle; text search is biased toward it.

typeoptional

string

A Google Places type such as `restaurant` or `dentist`.

languageoptional

string

BCP-47 language code for names and addresses.

regionoptional

string

CLDR region code that biases results, e.g. `DE`.

cursoroptional

string

Text-search pagination cursor. Nearby search does not page.

limitoptional

integer

Response

200Place hits and an optional cursor.

hits

object[]

cursor

string | null

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy