Google Maps Photos Endpoint
Return Google Maps photos for one place.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Google Maps Photos
Send the smallest useful request and read the structured response.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/photos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"num_results": 2
}'{
"success": true,
"time_taken": 0.442,
"place": {
"title": "Third Wave Coffee - Koramangala",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034, India",
"rating": 4.4,
"total_reviews": 5024
},
"categories": [],
"photos": [
{
"photo_id": "CIHM0ogKEICAgIDm5q_6-gE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"width": 768,
"height": 576
},
{
"photo_id": "CIHM0ogKEICAgIDujJqopAE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9S60JgBviPU8QvzaS4tF1j6tCNrlCfvY7ZCYRJiAk3gQhMizTTwF...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9S60JgBviPU8QvzaS4tF1j6tCNrlCfvY7ZCYRJiAk3gQhMizTTwF...",
"width": 1920,
"height": 1080
}
],
"next_page_token": "eyJjdXJzb3IiOiJFdmdES1lRaTQ5LU5sVU1JRHdBQUFBRUFBQU1BQUFBQUFJQUFBQUFJQUFBQUFBQUFBQVFBUUFBQUFBQUFBQUFB...",
"has_more": true
}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/photos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"num_results": 2,
"place_id": "ChIJEXAMPLE",
"cid": "1234567890123456789"
}'{
"success": true,
"time_taken": 0.442,
"place": {
"title": "Third Wave Coffee - Koramangala",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034, India",
"rating": 4.4,
"total_reviews": 5024
},
"categories": [],
"photos": [
{
"photo_id": "CIHM0ogKEICAgIDm5q_6-gE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"width": 768,
"height": 576
}
],
"next_page_token": "eyJjdXJzb3IiOiJFdmdES1lRaTQ5LU5sVU1JRHdBQUFBRUFBQU1BQUFBQUFJQUFBQUFJQUFBQUFBQUFBQVFBUUFBQUFBQUFBQUFB...",
"has_more": true
}Results and Pagination
Control how many records or pages are returned.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/photos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"num_results": 20
}'{
"success": true,
"time_taken": 0.442,
"place": {
"title": "Third Wave Coffee - Koramangala",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034, India",
"rating": 4.4,
"total_reviews": 5024
},
"categories": [],
"photos": [
{
"photo_id": "CIHM0ogKEICAgIDm5q_6-gE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"width": 768,
"height": 576
}
],
"next_page_token": "eyJjdXJzb3IiOiJFdmdES1lRaTQ5LU5sVU1JRHdBQUFBRUFBQU1BQUFBQUFJQUFBQUFJQUFBQUFBQUFBQVFBUUFBQUFBQUFBQUFB...",
"has_more": true
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/photos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc",
"num_results": 2,
"language": "en",
"country": "us"
}'{
"success": true,
"time_taken": 0.442,
"place": {
"title": "Third Wave Coffee - Koramangala",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034, India",
"rating": 4.4,
"total_reviews": 5024
},
"categories": [],
"photos": [
{
"photo_id": "CIHM0ogKEICAgIDm5q_6-gE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"width": 768,
"height": 576
}
],
"next_page_token": "eyJjdXJzb3IiOiJFdmdES1lRaTQ5LU5sVU1JRHdBQUFBRUFBQU1BQUFBQUFJQUFBQUFJQUFBQUFBQUFBQVFBUUFBQUFBQUFBQUFB...",
"has_more": true
}Additional Options
Set endpoint-specific options for this request.
curl -X POST "https://api.datablue.dev/v1/data/google/maps/photos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"data_id": "example",
"num_results": 2,
"category_id": "example",
"next_page_token": "example"
}'{
"success": true,
"time_taken": 0.442,
"place": {
"title": "Third Wave Coffee - Koramangala",
"address": "4th Block, 1, 984, 80 Feet Rd, Maharaja Signal, Koramangala, Bengaluru, Karnataka 560034, India",
"rating": 4.4,
"total_reviews": 5024
},
"categories": [],
"photos": [
{
"photo_id": "CIHM0ogKEICAgIDm5q_6-gE",
"category_id": "CgIgAQ==",
"thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"image": "https://lh3.googleusercontent.com/gps-cs-s/ANWiy9Q0lf80eTHevM6k2_NYO-w0Cu4O2Td8Kg_OAxRtwRPjRSGMdy2bt...",
"width": 768,
"height": 576
}
],
"next_page_token": "eyJjdXJzb3IiOiJFdmdES1lRaTQ5LU5sVU1JRHdBQUFBRUFBQU1BQUFBQUFJQUFBQUFJQUFBQUFBQUFBQVFBUUFBQUFBQUFBQUFB...",
"has_more": true
}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.
