Search APIs
Loading…
← API Store
Search & SEO

Google Maps

Google Maps

Google Maps place photos

GET /google-maps/v1/photos
Test this endpoint

The place's whole photo and video gallery, paged like the Maps gallery: each item has photo_id, photo_url, photo_url_large (=s0), size, location, date (photo_datetime_utc), type (photo or video), video_urls for videos and whether the owner uploaded it. Up to 200 per call (limit); pass next_cursor back as cursor (null on the last page). is_video=true keeps only videos. The first page also keeps the older photos list (cover photos and review photos). Identify the place by business_id or as for details.

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
feature_idstringThe place's Google data id (`0x…:0x…`), from search results (`feature_id`) or a Maps URL (`!1s0x…`). Example: 0x8644ca6bc309e81b:0x1f1a903bbb66839
cidstringThe place's CID (the number in `?cid=` Maps links), instead of feature_id.
urlstringA Google Maps place URL, instead of feature_id.
place_idstringGoogle place id (`ChI…`), alone (resolved through its Maps page) or with `q` (the place name and city).
qstringWith place_id, or alone: the place name and city to look up.
hlstringLanguage (default en).
glstringCountry (default us).
limitintegerPhotos to return (max 200).
business_idstringThe business: its `business_id` (`0x…:0x…`), `place_id` (`ChI…`) or `cid`, instead of feature_id. Example: 0x89c2598f7ff4aa09:0x313547e757cb8cea
cursorstringValue of `next_cursor` from the previous page.
is_videobooleantrue: only videos.
languagestringLanguage (same as `hl`, default en).
regionstringCountry (same as `gl`, default us).

Every endpoint also takes: fields、raw、fresh、output、records

{
  "cached": false,
  "credits_used": 1,
  "photos": [
    {
      "caption": null,
      "height": 1367,
      "id": "CIABIhCBrju2LNmiIE8BUuf1Z3Ib",
      "url": "https://lh3.googleusercontent.com/grass-cs/AABkmLfJIKtqpCzKk8ZK26sD-UimId0Y5kZKPzmvwB1d_IbomeNX4wXLTnEH9Vb9r-4VgnIAv2KGYZh26SDOe3YpjkZZ-p_Ik…",
      "width": 1080
    },
    {
      "caption": null,
      "height": 1560,
      "id": "CIHM0ogKEICAgIC9i7zAGw",
      "url": "https://lh3.googleusercontent.com/grass-cs/AABkmLfxnvwfIePp3G4HBtEOo7fwfEGvN6xKgaGGljP38EVP19oLpQisv3PCSKt3b-Ksq-AzR-LPWCyowl5VMEpSNJm7e1E26…",
      "width": 1171
    },
    "… 11 more"
  ],
  "photos_returned": 13,
  "place": {
    "feature_id": "0x397c4318fd9a8927:0xea7428bd31a33dd8",
    "name": "Nothing Before Coffee Cafe - Gulmohar, Bhopal",
    "photos_count": 1106,
    "place_id": "ChIJJ4ma_RhDfDkR2D2jMb0odOo"
  }
}
Response fields (16)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.cachedboolean
$.credits_usedinteger
$.photosarray
$.photos[]object | string
$.photos[].captionnull
$.photos[].heightinteger
$.photos[].idstring
$.photos[].urlstring
$.photos[].widthinteger
$.photos_returnedinteger
$.placeobject
$.place.feature_idstring
$.place.namestring
$.place.photos_countinteger
$.place.place_idstring