Business Photos Categories

Retrieve the list of available photo categories for a specific business. Use the returned category values with the Business Photos endpoint to filter photos by category. Categories are determined by Google based on the photos uploaded for the business.

HTTP Request

1
GET /business_photos_categories

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

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
  "status": true,
  "request_id": "e4cdc3dd-6748-35ca-94ff-5c576685",
  "data": [
    { "name": "All", "hash": "CgIgAQ==" },
    { "name": "Latest", "hash": "CgIgARICGAI=" },
    { "name": "Videos", "hash": "CgIgARICCAQ=" },
    { "name": "Inside", "hash": "CgIYEg==" },
    { "name": "Food", "hash": "CgwKCC9tLzAyd2JtMAE=" },
    { "name": "By owner", "hash": "CgIgARICEAE=" },
    { "name": "Street View & 360\u00b0", "hash": "CgIgARICCAI=" }
  ],
  "request_params": {
    "business_id": "0x89c6c62958fb0109:0xcd8fd007dc1d6b01"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	`true` when the request succeeded
`request_id`	string	Unique identifier for this request
`data`	array	List of photo categories for this business
`data[].name`	string	Human-readable category name
`data[].hash`	string	Base64 token to pass as `category_hash` to Business Photos

Notes

Categories vary by business. A restaurant exposes Food and Inside; a hotel or park returns a different set, so read them per business rather than hardcoding.
Pass the hash value, not the name, to the Business Photos endpoint. Filtering by name returns an empty result rather than an error.

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
import requests

url = "https://google-maps-extractor2.p.rapidapi.com/business_photos_categories"

querystring = {
    "business_id": "0x89c259a9aeb1c6b5:0x35b1cfbc380cb867",
    "language": "en",
    "country": "us"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()

print("Available photo categories:")
for category in data["data"]:
    print(f"  - {category}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
const url = "https://google-maps-extractor2.p.rapidapi.com/business_photos_categories";

const params = new URLSearchParams({
  business_id: "0x89c259a9aeb1c6b5:0x35b1cfbc380cb867",
  language: "en",
  country: "us",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "google-maps-extractor2.p.rapidapi.com",
  },
});

const data = await response.json();

console.log("Available photo categories:");
data.data.forEach((category) => console.log(`  - ${category}`));

1
2
3
4
5
6
curl -G "https://google-maps-extractor2.p.rapidapi.com/business_photos_categories" \
  --data-urlencode "business_id=0x89c259a9aeb1c6b5:0x35b1cfbc380cb867" \
  --data-urlencode "language=en" \
  --data-urlencode "country=us" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: google-maps-extractor2.p.rapidapi.com"

Business Photos — Fetch photos using the categories returned by this endpoint
Business Details — Get full business information