Place High-Resolution Photos

GET/v1/places/photos2 Credits / photo (min 6; 0 if empty)($0.0002 / photo ($0.08–$0.20 / 1K photos))

Retrieve high-resolution photo URLs, dimensions, categories (exterior, interior, food & drink, menu), and contributor attribution for a Google Maps business.

Parameters

place_idstringrequired
Google Maps Place ID or numeric CID.
Example: ChIJN5X_gWdZwokRck9rk2guJ1M
limitinteger (1 to 50)
Maximum number of photos to return (1 to 50, default 20).
Example: 20

Example Request (cURL / Python / JavaScript)

curl "https://api.googlemapsapi.io/v1/places/photos?place_id=ChIJN5X_gWdZwokRck9rk2guJ1M" \
  -H "x-api-key: gm_live_your_api_key"

Live Response Preview

{
  "request_id": "req_gm_55012e9ab304",
  "status": "ok",
  "data": [
    {
      "photo_id": "AF1QipN928172_felix_interior",
      "place_id": "ChIJN5X_gWdZwokRck9rk2guJ1M",
      "url": "https://lh5.googleusercontent.com/p/AF1QipN928172_felix_interior=w1600-h1200-k-no",
      "thumbnail_url": "https://lh5.googleusercontent.com/p/AF1QipN928172_felix_interior=w400-h300-k-no",
      "width": 1600,
      "height": 1200,
      "category": "Interior",
      "author_name": "Felix Roasting Co.",
      "uploaded_at": "2026-08-14T12:00:00Z"
    }
  ],
  "meta": {
    "credits_used": 6,
    "credits_remaining": 1944,
    "count": 1,
    "has_more": false,
    "next_cursor": null,
    "cache_hit": false
  }
}

Response Fields

List of high-resolution business photos.

Field	Type	Sample / Notes
`request_id`	string	Unique request trace identifier.
`status`	string	Response status ('ok').
`data`	array of PhotoItem	Business photos.
`photo_id`	string	Unique photo identifier.
`place_id`	string	Associated Google Maps Place ID.
`url`	string	High-resolution direct image URL.
`thumbnail_url`	string	Thumbnail image URL.
`width`	integer	Image width in pixels.
`height`	integer	Image height in pixels.
`category`	string	Photo classification (Interior, Exterior, Menu, Food & drink).
`author_name`	string	Uploader display name.
`uploaded_at`	string	ISO 8601 upload timestamp.
`meta`	ResponseMeta
`credits_used`	integer	Credits deducted for this API call.
`credits_remaining`	integer	Remaining credit balance on the account.
`count`	integer	Number of records returned in data.
`has_more`	boolean	Whether additional pages are available.
`next_cursor`	string	Opaque cursor token for fetching the next page.
`cache_hit`	boolean	Whether the response was served from the sub-50ms local index.

Status Codes

200: List of high-resolution business photos.