Google Shopping Filters API
Retrieve native filter groups, labels and query-bound shoprs selections from Google Shopping.
Make a request
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
POST /v1/google/shopping/filters
curl 'https://api.prismcrawl.com/v1/google/shopping/filters' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"query": "coffee grinder"
}'Supported parameters
| Parameter | Usage |
|---|---|
queryRequired | Text to search for on the selected service. |
country | Two-letter country or storefront code, such as us or gb. |
language | Provider-supported language code, such as en. |
location | Location to search around, such as Austin, TX. |
coordinates | Latitude and longitude for location targeting. |
uule | Encoded Google location; cannot be combined with location or coordinates. |
google_domain | Google country domain, such as google.com or google.co.uk. |
shoprs | Native Google filter token, or up to twenty tokens joined by ||. Supplies the query when query is omitted; named controls override corresponding filters. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
Structured results
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
input_typeoptionstypeSDKs and guides
The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
- Python SDK:
pip install prismcrawl - Node.js SDK:
npm install prismcrawl