# serp402 Google Shopping Filters

> serp402 Google Shopping Filters is a paid API for AI agents from serp402.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-31).

Extracts available Google Shopping filter options (text labels, shoprs tokens, and input types) for a given shopping query in structured JSON format.

## Facts

- Endpoint: POST https://serp402.com/api/v1/google-shopping-filters?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/serp402-google-shopping-filters-1aae016e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LAM2Q3x7cSXYd_rVv9Wpe

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 serp402-google-shopping-filters-1aae016e -d '<json body>'
```

Example prompt: Can you pull all the available Google Shopping filters for 'wireless headphones' in the US in English — I need the filter names, their shoprs tokens, and input types so I can build filter navigation for my app.

## When to prefer this

Use this endpoint when you need to discover and enumerate the filter options available for a specific Google Shopping query — especially when building programmatic shopping search flows, filter-driven UIs, or agent pipelines that need to apply refined filters via shoprs tokens. It is the right choice when you need the metadata (labels + tokens + input types) rather than the actual product results themselves.

## Known failure modes

- Invalid or unsupported gl/hl codes return an error or empty filter set
- Query returning no Shopping results yields empty filters array
- Malformed shoprs token causes filter endpoint to reject the request
- Payment failure (USDC x402) results in 402 response and no data returned
- Rate limiting or network errors may produce 5xx responses

## How this service works

Google Shopping Filters: Filters text, shoprs value and input type in code friendly JSON format. Structured JSON, USD 0.05 per call in USDC — no API key, no account, no subscription, no minimum. Not affiliated with, endorsed by or an official channel of any of the services the results come from. All trademarks and copyright remain the property of their respective owners.

## Output

Returns a structured JSON object containing Google Shopping filter metadata for the given query, including human-readable filter text labels, machine-readable shoprs tokens (needed to apply filters in subsequent searches), and the input type for each filter (e.g. checkbox, dropdown, range slider).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "q": {
   "type": "string"
  },
  "gl": {
   "type": "string",
   "description": "country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France) Head to the…"
  },
  "hl": {
   "type": "string",
   "description": "language to use for the Google Shopping search. It's a two or three-letter language code. (e.g., en for English, es for Spanish, or fr for French), optionally…"
  },
  "uule": {
   "type": "string",
   "description": "Parameter is the Google encoded location you want to use for the search. uule and location parameters can't be used together. For consistent results with…"
  },
  "shoprs": {
   "type": "string",
   "description": "The parameter defines the token that includes metadata about query and search filter(s)."
  },
  "location": {
   "type": "string",
   "description": "from where you want the search to originate. If several locations match the location requested, we'll pick the most popular one. Head to the /locations.json…"
  },
  "google_domain": {
   "type": "string",
   "description": "Google domain to use. It defaults to google.com . Head to the Google domains for a full list of supported Google domains."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/serp402-google-shopping-filters-1aae016e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from serp402.com](https://www.zero.xyz/host/serp402.com/llms.txt)