Retrieve photos for a specific business. Supports filtering by photo category and pagination for businesses with large photo collections. Use the Business Photos Categories endpoint to discover available categories before filtering.
HTTP Request
| |
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
business_id | string | Yes | — | Unique business identifier in hex format (0x...:0x...) or place ID |
language | string | No | "en" | Language code for the response |
country | string | No | "us" | Country code for regional context |
limit | integer | No | 20 | Maximum number of photos to return |
category | string | No | — | Filter photos by category (use Business Photos Categories endpoint to get available values) |
next_page_token | string | No | — | Pagination token from a previous response to fetch the next page |
Response
| |
Response Fields
| Field | Type | Description |
|---|---|---|
status | string | Request status |
data | array | List of photos |
data[].photo_url | string | URL of the photo |
data[].width | integer | Photo width in pixels |
data[].height | integer | Photo height in pixels |
data[].author | string | Photo contributor name |
data[].time | string | Upload timestamp (ISO 8601) |
next_token | string/null | Token for fetching the next page of photos |
Code Examples
| |
| |
| |
Related Endpoints
- Business Photos Categories — List available photo categories for filtering
- Business Details — Get full business information
- Business Reviews — Get reviews for this business