Google Immersive Product API | Rich Product Pages for E-Commerce Agents

Get Google's rich immersive product pages for any product search as clean structured JSON. Give the API a product query and get back the deep product detail page Google shows shoppers, for the top matching products: title, brand, price range across stores, the aggregated rating and full star-by-star review breakdown, specs, variants, the stores selling it, related videos, and sample user reviews. It is the structured version of the page your customers and competitors are looking at.

What you get

One row per product:

• title, brand, and price_range across stores
• rating and reviews count, plus a ratings star-by-star breakdown
• about_the_product specs, variants, and thumbnails
• stores selling the product, related videos, and user_reviews

Use cases

• Pull the full product page for e-commerce competitive intelligence
• Track a product's price range, rating, and review count over time
• Compare variants and specs across competing products
• Feed an AI shopping agent the rich product detail in one call
• Build product-research datasets with specs, ratings, and store coverage

Input

Field	Type	Description
query	string	A single product search, e.g. running shoes. Provide this, queries, or both.
queries	array of strings	A batch of product searches to run in one go. Merged with query and de-duplicated.
gl	string	Optional two-letter country code for pricing and localization. Default us.
hl	string	Optional two-letter language code. Default en.
maxResultsPerQuery	integer	Products per query to pull the rich page for. Default 10, maximum 20.

Example input

{
  "query": "running shoes",
  "gl": "us",
  "maxResultsPerQuery": 10
}

Sample output

{
  "result_type": "product",
  "query": "running shoes",
  "position": 1,
  "title": "Adidas Men's Adizero Evo SL",
  "brand": "adidas",
  "price_range": "$150-$150",
  "rating": 4.8,
  "reviews": 19093,
  "ratings": [ { "stars": 5, "amount": 16553 }, { "stars": 4, "amount": 1507 } ],
  "about_the_product": { "...": "..." },
  "variants": [ { "...": "..." } ],
  "stores": [ { "...": "..." } ],
  "thumbnails": [ "https://..." ]
}

Pricing

Pay-per-result: a small $0.005 per-query search fee (the lookup that finds the matching products) plus $0.015 per product page returned. Each product is a deep detail page, richer than a standard product listing, so a typical query is the price of one search plus the products it returns.

How to get started

1. Open Google Immersive Product API on the Apify Store.
2. Enter a query (or a queries list of product searches).
3. Set maxResultsPerQuery, then run the Actor.
4. Export the dataset as JSON, CSV, or Excel, or pull it from the API.

Prefer code? See johnvc's GitHub for setup guides and code examples.

Run from the API

curl -X POST "https://api.apify.com/v2/acts/johnvc~google-immersive-product-api/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"running shoes","maxResultsPerQuery":5}'

🔌 Use this API from Claude (MCP)

This Actor is compatible with the Model Context Protocol (MCP), so AI agents can call it as a tool. Add it through the hosted Apify MCP server using this Actor-specific URL:

https://mcp.apify.com/?tools=actors,docs,johnvc/google-immersive-product-api

If you run agents from Claude Code (free trial) or Claude Cowork (free trial), add the Apify MCP server and ask it to "pull the rich product pages for the top 10 running shoes and compare ratings."

Setup walkthrough:

Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp

MCP setup, step by step

Visual setup guides for each client (source and more assets: ApifyPublicData on GitHub):

Claude Cowork Desktop (free trial)

Claude Code (free trial)

Claude (website)

Cursor

ChatGPT

FAQ

What is an immersive product page? It is the rich product detail panel Google shows for a product, with specs, ratings, variants, stores, and reviews. This API returns that panel as structured data.

How does it find products? It runs a shopping search for your query, then pulls the immersive page for the top matching products, up to maxResultsPerQuery.

How many products come back? Up to maxResultsPerQuery (default 10) per query.

Can I research many products at once? Yes. Pass a queries list; each search is run independently and its products are tagged with the source query.

n8n integration

Available as an n8n community node, n8n-nodes-google-immersive-product-api. In n8n: Settings, Community Nodes, install n8n-nodes-google-immersive-product-api, then use it in any workflow (it also works as an AI Agent tool).

Featured Tasks

Ready-to-run examples that show this API solving a specific problem. Each opens its own setup so you can run it on your account in one click.

• Get Rich Product Detail Pages From a Google Search
• Get a Product's Ratings and Reviews From Google
• Get Apple Watch Prices and Ratings as JSON
• Get Laptop Prices, Brands, and Ratings as JSON

Last Updated: 2026.06.17