Search nearby places by freeform query

Stage 196: real nearby places for an arbitrary text query (e.g. "late night tacos", "dog-friendly patio") and an optional Google Places includedType filter — the same underlying integration /search wraps (searchNearbyPlacesByType: Overture/Geoapify's free local databases tried first, Stage 191, falling back to a real, budget-circuit-broken Google Places call for whatever gap remains), but without /search's restriction to this app's own enumerated cuisine/activity category ids. Each result carries a detailUrl to a real, permanent LocalSelections page when the place is confidently matched and not an unresolved duplicate of another listing (null otherwise — see the NearbyPlace schema). Requires the places scope. Costs 1 unit of the key's rate-limit budget per call. Stage 198: on top of that shared per-minute budget, a free-tier key is separately capped at 100 calls/day to this endpoint specifically (see the 429 response) — commercial use is exempt (see GET /introspect's commercial field and the API Terms of Use).

post/places

Request

  • Base URL: https://localselections.com/api/v1
  • URL: https://localselections.com/api/v1/places
  • Auth: API key in header X-API-Key

Request body

querystring required

Freeform search text, e.g. "sushi", "hiking trail", "dog-friendly patio".

includedTypestring

Optional Google Places type filter, e.g. "restaurant", "park", "bowling_alley".

latnumber required
lngnumber required

Response

Nearby places for the requested query.

Changes

No recorded changes to this operation across all 1 revision of this API.