72M+ points of interest across 400+ categories
Search for places by name, type, or free-text query. Get rich results with business names, categories, addresses, and coordinates.
Find places near a specific location. Filter by category, set radius limits, and sort by distance or relevance.
Filter by 400+ categories including restaurants, hotels, stores, services, attractions, and more.
Find all locations of a specific brand or chain. Get every Starbucks, McDonald's, or any other business.
Get counts and stats by category, country, or region. Perfect for market research and analysis.
Find places similar to a given location. Great for competitor analysis and recommendations.
Complete list of Places API endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/places | Search places by name, category, or query |
| GET | /v1/places/nearby | Find places near a coordinate with radius filter |
| GET | /v1/places/categories | List all available place categories |
| GET | /v1/places/brands | List available brands with place counts |
| GET | /v1/places/chain | Get all locations of a specific brand/chain |
| GET | /v1/places/count | Count places matching criteria (category, brand, location) |
| GET | /v1/places/similar | Find places similar to a given place |
| GET | /v1/places/stats | Get database statistics by country and category |
| GET | /v1/places/random | Get random sample places (for testing) |
| POST | /v1/places/batch | Batch lookup multiple places by ID |
| GET | /v1/places/{id} | Get detailed information about a specific place |
GET /v1/places?q=starbucks&country=US&city=Seattle&limit=10&api_key={key}
Response:
{
"results": [{
"id": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6",
"name": "Starbucks",
"category": "coffee_shop",
"categories": ["coffee_shop", "cafe", "food_and_beverage"],
"lat": 47.6097,
"lng": -122.3331,
"formatted_address": "1912 Pike Pl, Seattle, WA 98101",
"phone": "+1-206-448-8762",
"website": "https://starbucks.com",
"brand": "Starbucks"
}],
"total": 245
}GET /v1/places/nearby?lat=40.7128&lng=-74.0060&radius=1000&category=restaurant&limit=20&api_key={key}
Response:
{
"results": [
{ "name": "Joe's Pizza", "category": "restaurant", "distance_meters": 45, ... },
{ "name": "Thai Express", "category": "restaurant", "distance_meters": 120, ... },
{ "name": "Shake Shack", "category": "fast_food", "distance_meters": 230, ... }
]
}GET /v1/places/chain?brand=Starbucks&country=US&state=CA&limit=100&api_key={key}
Response:
{
"brand": "Starbucks",
"total_locations": 3247,
"results": [
{ "id": "abc123", "name": "Starbucks", "lat": 37.7749, "lng": -122.4194, ... },
{ "id": "def456", "name": "Starbucks Reserve", "lat": 34.0522, "lng": -118.2437, ... },
...
]
}GET /v1/places/08f28a8f-8c8b-4896-815e-c92c8df0a8a6?api_key={key}
Response:
{
"id": "08f28a8f-8c8b-4896-815e-c92c8df0a8a6",
"name": "Starbucks Reserve Roastery",
"category": "coffee_shop",
"lat": 47.6142,
"lng": -122.3281,
"formatted_address": "1124 Pike St, Seattle, WA 98101",
"phone": "+1-206-624-0173",
"website": "https://www.starbucksreserve.com",
"brand": "Starbucks",
"confidence": 0.98
}