Place search API for AI agents
Search 88.4 million businesses and landmarks in 248 countries and territories, over MCP or REST. The data is openly licensed, so your agent can cache, store and reuse every result.
The same search, two ways in. Both use one server-side key and count against the same prepaid balance.
claude mcp add --transport http openplacesapi \ https://app.openplacesapi.com/mcp \ --header "Authorization: Bearer $OPA_KEY"
{
"mcpServers": {
"openplacesapi": {
"url": "https://app.openplacesapi.com/mcp",
"headers": {
"Authorization": "Bearer ${env:OPA_KEY}"
}
}
}
}codex mcp add openplacesapi \ --url https://app.openplacesapi.com/mcp \ --bearer-token-env-var OPA_KEY
Streamable HTTP: https://app.openplacesapi.com/mcp Authorization: Bearer $OPA_KEY Tools: search_places, list_categories
curl -G https://api.openplacesapi.com/v1/places \ -d q=coffee -d lat=40.7411 -d lon=-73.9897 \ -H "Authorization: Bearer $OPA_KEY"
const query = new URLSearchParams({
q: "coffee", lat: "40.7411", lon: "-73.9897"
});
const response = await fetch(
`https://api.openplacesapi.com/v1/places?${query}`,
{ headers: { Authorization: `Bearer ${process.env.OPA_KEY}` } }
);
if (!response.ok) throw new Error(await response.text());
const places = await response.json();import json, os, urllib.request
url = "https://api.openplacesapi.com/v1/places?q=coffee&lat=40.7411&lon=-73.9897"
request = urllib.request.Request(url, headers={
"Authorization": "Bearer " + os.environ["OPA_KEY"]
})
with urllib.request.urlopen(request, timeout=30) as response:
places = json.load(response){
"results": [
{
"place_id": "overture:a27acb33-8aaf-4cf8-a979-4dc1cfe5dc82",
"name": "Joe Coffee Company",
"lat": 40.741379,
"lon": -73.98967,
"distance_mi": 0.03,
"category": "coffee_shop",
"categories": [
"coffee_shop"
],
"category_hierarchy": [
"food_and_drink",
"non_alcoholic_beverage_venue",
"coffee_shop"
],
"address": {
"formatted": "186 5th Ave",
"street": "186 5th Ave",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "9177169909",
"website": "https://joecoffeecompany.com/",
"confidence": 0.99,
"match": "category"
}
]
} The live demo needs no key. Results come back as plain records: names, categories, coordinates and how sure the source is.
{
"results": [
{
"place_id": "overture:a27acb33-8aaf-4cf8-a979-4dc1cfe5dc82",
"name": "Joe Coffee Company",
"lat": 40.741379,
"lon": -73.98967,
"distance_mi": 0.03,
"category": "coffee_shop",
"categories": [
"coffee_shop"
],
"category_hierarchy": [
"food_and_drink",
"non_alcoholic_beverage_venue",
"coffee_shop"
],
"address": {
"formatted": "186 5th Ave",
"street": "186 5th Ave",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "9177169909",
"website": "https://joecoffeecompany.com/",
"confidence": 0.99,
"match": "category"
},
{
"place_id": "overture:8fbd5104-4f70-46f4-9ee9-9cd786ebd036",
"name": "Gumption Coffee",
"lat": 40.740881,
"lon": -73.989292,
"distance_mi": 0.04,
"category": "coffee_shop",
"categories": [
"coffee_shop"
],
"category_hierarchy": [
"food_and_drink",
"non_alcoholic_beverage_venue",
"coffee_shop"
],
"address": {
"formatted": "940 Broadway",
"street": "940 Broadway",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "8456056218",
"website": "http://www.gumptioncoffee.com/",
"confidence": 0.99,
"operating_status": "open",
"match": "name_and_category"
},
{
"place_id": "overture:9e2e2431-1ab7-4408-8ae9-9a3cca887d63",
"name": "Flatiron Green",
"lat": 40.741293,
"lon": -73.989296,
"distance_mi": 0.04,
"category": "coffee_shop",
"categories": [
"coffee_shop"
],
"category_hierarchy": [
"food_and_drink",
"non_alcoholic_beverage_venue",
"coffee_shop"
],
"address": {
"formatted": "Broadway",
"street": "Broadway",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "(917) 504-6209",
"website": "http://flatirongreencafe.com",
"confidence": 0.96,
"operating_status": "open",
"match": "category"
},
{
"place_id": "overture:ae6739ff-5cdd-4d00-a8db-5122de342ed6",
"name": "Benvenuto Cafe Restaurant",
"lat": 40.741184,
"lon": -73.989086,
"distance_mi": 0.05,
"category": "cafe",
"categories": [
"cafe"
],
"category_hierarchy": [
"food_and_drink",
"casual_eatery",
"cafe"
],
"address": {
"formatted": "950 Broadway",
"street": "950 Broadway",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "(212) 614-7224",
"website": "http://benvenutonyc.com",
"confidence": 0.92,
"operating_status": "permanently_closed",
"match": "category"
},
{
"place_id": "overture:4296a475-e922-43be-9187-1f374a6a8da3",
"name": "Starbucks",
"lat": 40.741796,
"lon": -73.990215,
"distance_mi": 0.06,
"category": "coffee_shop",
"categories": [
"coffee_shop"
],
"category_hierarchy": [
"food_and_drink",
"non_alcoholic_beverage_venue",
"coffee_shop"
],
"address": {
"formatted": "14 W 23rd St (23rd Btwn 5th & 6th)",
"street": "14 W 23rd St (23rd Btwn 5th & 6th)",
"locality": "New York",
"region": "ny",
"postal_code": "10010",
"country_code": "US"
},
"phone": "2123672050",
"confidence": 0.99,
"operating_status": "open",
"match": "category"
}
],
"meta": {
"request_id": "c49ea921-d98c-4161-8683-642947d4f3e5",
"data_source": "overture",
"data_release": "2026-10-21.0",
"data_releases": [
"2026-10-21.0"
],
"q": "coffee",
"mode": "all",
"lat": 40.741,
"lon": -73.99,
"radius_mi": 25,
"limit": 5,
"offset": 0,
"next_offset": null,
"category": null,
"min_confidence": null,
"sort": "relevance",
"interpreted_as": {
"type": "category",
"categories": [
"coffee_shop",
"cafe"
],
"text": null,
"message": "Read \"coffee\" as the category coffee_shop (also cafe): places in that category come first, then other name matches. Use mode=name to match names only, or category=coffee_shop with offset to page through every match."
},
"warnings": [],
"layer_selection": {
"source": "default",
"preset": null,
"layers": [
{
"type": "overture_base"
},
{
"type": "open"
}
]
}
}
}The same search result, as each provider lets you keep it in your database 31 days later.
Everything, for as long as you want, under the source licenses.
Place IDs indefinitely. Coordinates may be cached for up to 30 days.
Place IDs and photo IDs may be cached indefinitely. No other attributes on pay-as-you-go.
No POI fields beyond 30 days. Building a POI database is also prohibited.
Checked 2026-11-10. One real Overture record illustrates field retention; each provider uses its own records and identifiers. Open-data licenses and attribution requirements apply (CDLA-Permissive 2.0, Apache 2.0, CC0). Standard terms: Google policies and service terms; Foursquare usage guidelines (pay-as-you-go); Radar terms §2(d). Contract-specific exceptions may apply. Record: Overture 2026-10-21.0.
Every country and territory with indexable Overture Places data, updated from Overture's monthly releases. Density and field completeness vary by place.
1,813 places per km²
1,448 places per km²
1,504 places per km²
811 places per km²
103 places per km²
Layers sit on top of the open base data and belong to your account. Changes show up on the next request.
Start with 2,500 free searches, once per account. No credit card.
| Pay once | Searches | Per 1,000 |
|---|---|---|
| $10 | 5,000 | $2.00 |
| $25 | 15,000 | $1.67 |
| $50 | 50,000 | $1.00 |
| $100 | 125,000 | $0.80 |
| $250 | 400,000 | $0.63 |
The whole balance expires 12 months after your most recent purchase, or 12 months after your free grant starts. Buying keeps all unused searches and extends their expiry. Need more than 400,000? Email us.
Past your cap, the API answers 402 quota_exhausted. Your bill never surprises you, and your agent can tell why.
Open Places does one job. If you need one of these, pair it with another service.
2,500 free searches once, no card. Sign in with Google or GitHub.