Docs / API reference

POST/v1/data/google/maps/photos

Google Maps Photos

Return Google Maps photos for one place.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

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
}'
Example response
{
  "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"
}'
Example response
{
  "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
}'
Example response
{
  "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"
}'
Example response
{
  "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"
}'
Example response
{
  "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.

Parameters

NameTypeRequirementDescription
data_idstringOptionalGoogle Maps data ID from Google Maps results, e.g. 0x3bae1549cc5cf6f5:0x3b9120fad40e4ffc. Send one of data_id, place_id, or cid.
place_idstringOptionalGoogle Place ID, e.g. ChIJ9fZczEkVrjsR_E8O1PogkTs.
cid / ludocidstringOptionalGoogle Maps CID (decimal business ID).
languagestringOptionalResult language.
countrystringOptionalTwo-letter country code for the Google market.
category_idstringOptionalOnly photos in one category from the categories list.
num_resultsnumberOptionalPhotos per page (1-20).
next_page_tokenstringOptionalToken from the previous response to fetch the next page.

Response fields

FieldTypeDescription
successbooleanFalse when the place could not be found.
placeobjecttitle, address, rating, and total_reviews.
photosarrayRows with photo_id, category_id, image, thumbnail, width, and height.
categoriesarrayPhoto categories Google shows for the place; may be empty.
next_page_token / has_morestring | booleanPagination for the next page.
time_takennumberAPI response time in seconds.

Request and 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
}'
Example response
{
  "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
}