# Google Shopping Product Reviews (V2)

> Google Shopping Product Reviews (V2) is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Fetches paginated product reviews from Google Shopping's new layout, including ratings, review counts, and review text, for a given product ID.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-product-search/v2/product-reviews?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-google-shopping-product-reviews-v2-44fe777d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lMNZb4Z2uHkrp5a5HfNuy

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-google-shopping-product-reviews-v2-44fe777d
```

Example prompt: Can you pull up the top 20 most recent customer reviews for Google Shopping product ID '1234567890' in the US, filtered to only show 4-star and above ratings?

## When to prefer this

Use this endpoint when you need product reviews from the new Google Shopping UI layout for supported countries (listed in description). It supports pagination via cursor, rating filtering, language/country localization, and sort ordering. For unsupported countries, use the Google Shopping V1 Product Reviews endpoint instead. Prefer this over generic web scraping when you need structured review data including rating distribution and pagination.

## Known failure modes

- Invalid or missing product_id returns an error or empty results
- Product ID not found on Google Shopping returns empty data
- Country code not in the supported new-layout country list may return no results (use V1 endpoint instead)
- Invalid rating filter value (outside 1–5) may return an error
- Expired or invalid cursor returns an error or first-page results
- Rate limiting or quota exhaustion returns a 402 or 429 error

## How this service works

Get all product reviews with pagination/scrolling support.  

  This endpoint provides the data and functionality available on the new Google Shopping layout / UI.  
  
  At that moment, the new Google Shopping layout is available on the following countries:  
  `ai, gb, in, aw, ar, at, au, br, bm, io, be, ky, ca, cl, co, cc, cx, dk, cz, fk, fi, pf, fr, tf, de, gf, gp, hk, hm, hu, gr, id, in, il, it, ie, jp, kr, my, yt, mx, mq, ms, nc, nl, no, nf, ph, nz, ro, pt, re, ru, pl, sa, pm, sg, sk, za, se, tw, gs, tk, th, ch, tc, ua, es, ae, vg, tr, us, gb, vn, wf`  
  
  For other countries, use the "Product Reviews" endpoint under "Google Shopping V1" instead.  
  We are monitoring this change and will add support for other countries as they are rolled out to Google Shopping.

## Output

Returns a JSON object containing the average product rating, total review count, a breakdown of reviews per star rating (1–5), and a list of reviews with pagination cursor for fetching subsequent pages. Also includes a request ID and status field.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "product_id"
 ],
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of product reviews to return."
  },
  "cursor": {
   "type": "string",
   "description": "A cursor to get the next set of results, it can be used for for paging purposes.  \n  **Note:** the cursor value for the next set of results is returned by this endpoint under data.cursor."
  },
  "rating": {
   "type": "string",
   "default": 0,
   "description": "Only return reviews with user rating greater than the specified value. Allowed values: 1-5."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the region/country. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."
  },
  "sort_by": {
   "enum": [
    "MOST_RELEVANT",
    "MOST_RECENT"
   ],
   "type": "string",
   "default": "MOST_RELEVANT",
   "description": "Return reviews in a specific sort order."
  },
  "language": {
   "type": "string",
   "default": "en",
   "description": "The language of the results. Allowed values: See https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes."
  },
  "product_id": {
   "type": "string",
   "description": "Product id of the product for which to fetch reviews."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "cursor": {
     "type": "string",
     "description": "A pagination cursor for retrieving more reviews"
    },
    "product_rating": {
     "type": "number",
     "description": "The average rating of the product"
    },
    "reviews_per_rating": {
     "type": "object",
     "properties": {
      "1": {
       "type": "integer",
       "description": "The number of 1-star reviews"
      },
      "2": {
       "type": "integer",
       "description": "The number of 2-star reviews"
      },
      "3": {
       "type": "integer",
       "description": "The number of 3-star reviews"
      },
      "4": {
       "type": "integer",
       "description": "The number of 4-star reviews"
      },
      "5": {
       "type": "integer",
       "description": "The number of 5-star reviews"
      }
     }
    },
    "product_num_reviews": {
     "type": "integer",
     "description": "The total number of reviews for the product"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response"
  },
  "request_id": {
   "type": "string",
   "description": "A unique identifier for the request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-google-shopping-product-reviews-v2-44fe777d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
