Google Maps Place Endpoint
Return one Google Maps place with contact details, rating breakdown, hours and categories.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google Maps Place
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc"
}'{
"success": true,
"time_taken": 1.414,
"place": {
"title": "Third Wave Coffee - Koramangala",
"place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"data_cid": "4292248181532413948",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
"latitude": 12.934721699999999,
"longitude": 77.6295729,
"google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
"website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
"phone": "073376 84222",
"international_phone": "+91 73376 84222",
"rating": 4.4,
"review_count": 5024,
"rating_summary": [
{
"stars": 1,
"amount": 138
},
{
"stars": 2,
"amount": 98
}
],
"open_now": true,
"type": "Cafe",
"subtypes": [
"Cafe",
"Coffee roastery"
],
"photo_count": 3122,
"working_hours": [
{
"day": "Sunday",
"hours": "8 am–1 am"
},
{
"day": "Monday",
"hours": "8 am–1 am"
}
]
}
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"place_id": "ChIJEXAMPLE",
"cid": "1234567890123456789"
}'{
"success": true,
"time_taken": 1.414,
"place": {
"title": "Third Wave Coffee - Koramangala",
"place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"data_cid": "4292248181532413948",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
"latitude": 12.934721699999999,
"longitude": 77.6295729,
"google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
"website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
"phone": "073376 84222"
}
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"language": "en",
"country": "us"
}'{
"success": true,
"time_taken": 1.414,
"place": {
"title": "Third Wave Coffee - Koramangala",
"place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"data_cid": "4292248181532413948",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
"latitude": 12.934721699999999,
"longitude": 77.6295729,
"google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
"website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
"phone": "073376 84222"
}
}Additional Options
Set endpoint-specific options for this request.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/place" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "example"
}'{
"success": true,
"time_taken": 1.414,
"place": {
"title": "Third Wave Coffee - Koramangala",
"place_id": "ChIJ9fZczEkVrjsR_E8O1PogkTs",
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"data_cid": "4292248181532413948",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034",
"latitude": 12.934721699999999,
"longitude": 77.6295729,
"google_maps_url": "https://www.google.com/maps?cid=4292248181532413948",
"website": "https://stores.thirdwavecoffeeroasters.com/store-pages/third-wave-coffee-koramangala-bengaluru/",
"phone": "073376 84222"
}
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.
