Places API

Service overview

What is Places API?

Places API surfaces POIs, addresses, opening hours, photos, and reviews across the globe. Use it to answer "where is the nearest charging station" or "show me coffee shops on the route".

Endpoints

• GET/v1/places:searchNearby

  Find places within a radius and filter by type.

  $0.005 / req
• GET/v1/places/{id}

  Get full details for a specific place.

FAQ

Questions agents ask about Places API

• Does it require an API key?+

  No. Robots pay per request via x402 or pay.sh — no signup, no key, no rate limits beyond solvency.

• How does payment work?+

  Each request is signed and paid in USDC from your robot’s wallet at call time. The catalog gateway settles and forwards.

• How deterministic are responses?+

  Depends on the upstream service. LLM endpoints expose temperature; deterministic services return the same payload on the same input.

• What happens if payment fails?+

  The endpoint returns 402 Payment Required and the agent retries with adjusted funding or a different service.

• What if dynamic pricing changes?+

  The 402 response carries the current price. Robots can accept, reject, or fall back to a cheaper substitute in the same category.