# Google Shopping Full Search (US)

> Google Shopping Full Search (US) 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).

Search Google Shopping for product listings with full details, sponsored products, and filter refinements by keyword and optional filters.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-product-search/search-v2?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-full-search-us-9607ec2f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0Ygo6NfTwEX6ccSC7Nqmr

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-full-search-us-9607ec2f
```

Example prompt: Search Google Shopping for wireless noise-cancelling headphones under $200, sort by lowest price, only show items with free shipping, and return the top 20 results from US stores.

## When to prefer this

Use this endpoint when you need comprehensive Google Shopping product listings including full product details, sponsored results, and filter refinements — particularly for US-focused shopping queries. Prefer it over simpler search APIs when you need rich filtering (price range, store, condition, sale status, free shipping/returns), pagination across large result sets, or when you want to chain filter refinements using the returned shoprs parameters to progressively narrow results.

## Known failure modes

- Missing required 'q' parameter returns a 400 validation error
- Invalid country or language code may return empty results or an error
- Price range with min_price greater than max_price may return zero results
- Unsupported store name in 'stores' filter may silently return no results
- Exceeding page limit (>100) returns a validation error
- Rate limit or quota exhaustion returns a 402 or 429 error
- Query returning no Google Shopping matches yields an empty product array

## How this service works

Search and get product listings (including full product details), sponsored products, and search filters / refinements from Google Shopping.

## Output

Returns a JSON object containing an array of product listings with full product details (name, price, store, images, ratings, etc.), sponsored products, and an array of search filter objects with titles, selectable values, and associated shoprs/query parameters for refining results. Also includes a request ID and status field.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "description": "Search query / keyword"
  },
  "page": {
   "type": "integer",
   "default": 1,
   "maximum": 100,
   "minimum": 1,
   "description": "Results page to return (each page contains up to 100 product results)."
  },
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 100,
   "minimum": 1,
   "description": "Maximum number of products to return."
  },
  "shoprs": {
   "type": "string",
   "description": "The parameter controls filtering, along with the q parameter.  \n  It should be used in combination with the updated q parameter, which now contains the name of the filter applied next to your original query.  \n  You can get the shoprs filter value from the response of this endpoint, under the filters response field.  \n  In addition, it can be obtained directly from Google Shopping and used with the endpoint."
  },
  "stores": {
   "type": "string",
   "description": "Only return product offers from specific stores.  Accepts a single or a comma delimited list of store names (e.g. best buy,walmart,amazon)."
  },
  "country": {
   "type": "string",
   "default": "us",
   "description": "Country code of the region/country to return offers for. Allowed values: See https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2."
  },
  "on_sale": {
   "type": "boolean",
   "default": false,
   "description": "Only return product offers that are currently on sale."
  },
  "sort_by": {
   "enum": [
    "BEST_MATCH",
    "TOP_RATED",
    "LOWEST_PRICE",
    "HIGHEST_PRICE"
   ],
   "type": "string",
   "default": "BEST_MATCH",
   "description": "Sort product offers by best match, top rated, lowest or highest price."
  },
  "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."
  },
  "max_price": {
   "type": "number",
   "description": "Only return product offers with price lower than a certain value"
  },
  "min_price": {
   "type": "number",
   "description": "Only return product offers with price greater than a certain value"
  },
  "free_returns": {
   "type": "boolean",
   "default": false,
   "description": "Only return product offers that offer free returns."
  },
  "free_shipping": {
   "type": "boolean",
   "default": false,
   "description": "Only return product offers that offer free shipping/delivery."
  },
  "return_filt
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "filters": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "title": {
        "type": "string",
        "description": "The title of the filter."
       },
       "values": {
        "type": "array",
        "items": {
         "type": "object",
         "properties": {
          "q": {
           "type": "string",
           "description": "The query parameter value for the filter."
          },
          "title": {
           "type": "string",
           "description": "The display name of the filter value."
          },
          "shoprs": {
           "type": "string",
           "description": "A reference ID for shopping results."
          }
         }
        }
       },
       "multivalue": {
        "type": "boolean",
        "description": "Indicates if multiple values can be selected for the filter."
       }
      }
     }
    }
   }
  },
  "status": {
   "type": "string",
   "description": "The status of the response, indicating success or failure."
  },
  "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-full-search-us-9607ec2f/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)