Places API
72M+ points of interest and businesses across 400+ categories
72M+
POIs
400+
Categories
11
Endpoints
Places API Features
Place Search
Search for places by name, type, or free-text query. Get rich results with business names, categories, addresses, and coordinates.
Nearby Search
Find places near a specific location. Filter by category, set radius limits, and sort by distance or relevance.
Category Filtering
Filter by 400+ categories including restaurants, hotels, stores, services, attractions, and more.
Brand & Chain Lookup
Find all locations of a specific brand or chain. Get every Starbucks, McDonald's, or any other business.
Statistics & Analytics
Get counts and stats by category, country, or region. Perfect for market research and analysis.
Similar Places
Find places similar to a given location. Great for competitor analysis and recommendations.
All 11 Endpoints
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 |
Code Examples
Search Places
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
}Nearby Search
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, ... }
]
}Chain Locations
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 Place by ID
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
}Top Place Categories
2M+
Restaurants
1.4M+
Beauty Salons
1.3M+
Hotels
1M+
Clothing Stores
926K+
Churches
711K+
Cafes
686K+
Coffee Shops
652K+
Gas Stations