Google Immersive Product API
Get Google's rich immersive product pages for any product search as structured JSON: title, brand, price range, aggregated rating and review breakdown, specs, variants, stores, videos, and user reviews. For e-commerce competitive intelligence and product research agents. Pay per product, MCP-ready.
MEDIAN LAGon demand
PARAMETERS5
TOTAL USERS11
MONTHLY ACTIVE9
TOTAL RUNS115
RUNS SUCCEEDED100.0%
RATING5.0 (1)
Input parameters
| PARAMETER | TYPE | REQ | DEFAULT | DESCRIPTION |
|---|---|---|---|---|
| query | string | no | — | Enter a single product search, for example 'running shoes' or 'wireless earbuds'. Provide this, `queries`, or both. |
| queries | string[] | no | — | Provide a list of product searches to run in one batch. |
| gl | string | no | us | Set the two-letter country code for pricing and localization (e.g. 'us', 'gb', 'de'). |
| hl | string | no | en | Set the two-letter interface language code (e.g. 'en', 'es', 'de'). |
| maxResultsPerQuery | integer | no | 10 | How many products to return the rich immersive page for, per query. — drives your bill |
Worked examples
{
"query": "running shoes",
"queries": [
"example"
]
}
Tasks
Saved runs with the inputs already filled in — each one a standalone page and a working configuration example.
Code
curl
curl -X POST "https://api.apify.com/v2/acts/johnvc~google-immersive-product-api/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "running shoes", "queries": ["example"]}'
Python
from apify_client import ApifyClient
client = ApifyClient("APIFY_TOKEN")
run = client.actor("johnvc/google-immersive-product-api").call(
run_input={'query': 'running shoes', 'queries': ['example']}
)
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item)