{"uid":"cap_LAM2Q3x7cSXYd_rVv9Wpe","slug":"serp402-google-shopping-filters-1aae016e","name":"serp402 Google Shopping Filters","description":"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.","url":"https://serp402.com/api/v1/google-shopping-filters?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iREnC--iWod8YtMBV6V3N","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts available Google Shopping filter options (text labels, shoprs tokens, and input types) for a given shopping query in structured JSON format.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Building a shopping filter UI","prompt":"Get me all the available Google Shopping filters for 'running shoes' targeting the US market in English — I need the filter labels, their shoprs values, and what kind of inputs they are so I can render them in my store's search UI."},{"title":"Narrowing product search programmatically","prompt":"I'm searching for 'gaming laptops' on Google Shopping for users in France in French — can you fetch all available filter options including their shoprs tokens so I can let users refine results by brand, price, and features?"},{"title":"Comparing filter options across regions","prompt":"Fetch the Google Shopping filters for 'winter jackets' for both the US (gl=us, hl=en) and UK (gl=uk, hl=en) so I can see which filter categories and shoprs tokens differ between the two markets."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:49.735Z","isFirstParty":false,"canonicalSlug":"serp402-google-shopping-filters-1aae016e"}