Place search
GET /api/place-search · Cached 1hSearch OpenStreetMap for places by keyword, optionally restricted to a bounding box or country. Returns ranked hits with coordinates and place type - e.g. coffee shops in a city, airports in a region. ?q=coffee&viewbox=-122.52,37.81,-122.35,37.70&bounded=1.
Input
| Field | Type | Description |
|---|---|---|
q * | string | Free-form place query |
limit | number | Results to return, 1-20 (default 5) |
countryCodes | string | Comma-separated ISO-3166-1 alpha-2 codes (optional) |
viewbox | string | Bounding box as 'west,north,east,south' (lon/lat). Optional. |
bounded | string | If '1' and viewbox set, restrict strictly to box (default 0) |
Example output
{
"query": "Eiffel Tower",
"count": 1,
"results": [
{
"displayName": "Eiffel Tower, 5, Avenue Anatole France, Quartier du Gros-Caillou, Paris 7e Arrondissement, Paris, …, France",
"lat": 48.8582599,
"lon": 2.2945006,
"type": "attraction",
"class": "tourism",
"importance": 0.84,
"osm": "way/5013364",
"boundingBox": {
"south": 48.8574753,
"north": 48.8590453,
"west": 2.2933342,
"east": 2.2956671
}
}
],
"source": "nominatim.openstreetmap.org (ODbL)"
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/place-search?q=Eiffel+Tower&limit=3"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/place-search?q=Eiffel+Tower&limit=3");
Part of these workflows
This tool is one step in a curated multi-tool workflow - agents can fetch the whole sequence as an MCP prompt or call https://agent402.tools/api/skill-packs/{slug}/prompt.
- Location intel - Point at an address (or even a rough place name) and assemble the situational brief: precise coordinates, the canonical postal address, what's within walking distance, the live weather forecast, active NWS hazard alerts, and recent seismic activity. The deterministic 'what should I know about this place right now?' workup.
Related tools
US gov dataset search
GET /api/gov-dataSearch 300,000+ US government datasets on catalog.data.gov (CKAN): titles, publishing org, formats, and direct resource …
US weather alerts
GET /api/weather-alertsActive National Weather Service alerts for a US state as clean JSON: event, severity, headline, affected areas, onset/ex…
Recent earthquakes (USGS)
GET /api/earthquakesReal-time USGS earthquake feed: magnitude, place, time, depth, coordinates. Live government data, no key. ?minMag=4.5&pe…