Google

Google Shopping Light

Retrieve real catalog products, prices, merchants and ratings from the native Google Shopping surface. Responses identify source_surface as shopping and expose continuation only when the source supplies a next-page link.

post/v1/google/shopping/light

Request

  • Base URL: https://api.prismcrawl.com
  • URL: https://api.prismcrawl.com/v1/google/shopping/light
  • Auth: API key in header x-api-key

Request body

querystring

Text to search for on the selected service. At most 8,192 UTF-8 bytes.

countrystring

Two-letter country or storefront code, such as us or gb.

languagestring

Provider-supported language code, such as en.

pageinteger

One-based page number.

device'desktop' | 'mobile' | 'tablet'

Device presentation for the source request.

htmlboolean

Return the encoded original response rather than parsed JSON.

zero_traceboolean

Do not archive source or parsed response artifacts.

locationstring

Location to search around, such as Austin, TX.

safe'active' | 'off'

Provider safe-search filtering.

uulestring

Encoded Google location; cannot be combined with location or coordinates.

google_domainstring

Google country domain, such as google.com or google.co.uk.

startinteger

Source result offset, starting at zero. The provider determines page size.

shoprsstring

Native Google filter token, or up to twenty tokens joined by ||. Supplies the query when query is omitted; named controls override corresponding filters.

min_pricenumber

Lower price bound in the source country currency. Overrides the corresponding shoprs bound.

max_pricenumber

Upper price bound in the source country currency. Overrides the corresponding shoprs bound.

sort_by'1' | '2'

Price sorting: 1 for low to high, 2 for high to low. Overrides shoprs sorting.

free_shippingboolean

Enable or disable the native free shipping filter, overriding shoprs.

on_saleboolean

Enable or disable the native on sale filter, overriding shoprs.

small_businessboolean

Enable or disable the native small business filter, overriding shoprs.

output'json' | 'html' | 'md' | 'null' nullable

Response content format. md returns Markdown in data.content with data.format=md; the JSON success/request envelope remains. Accept: text/markdown also selects Markdown unless output or html=true is explicit. html is an alias for html=true and retains the existing Brotli/Base64 source format.

json_restrictorstring nullable

Select fields within data.content for JSON or Markdown. Supports comma-separated paths, non-negative array indices, half-open slices [0:3] (either bound may be omitted), [] and .{nested,subqueries}. Up to128 selections and16 levels. Missing fields are omitted; selected declared fields retain their zero defaults. The request envelope and credit headers remain. Include next_page_token when pagination is needed. Incompatible with HTML output. This changes response presentation only; tracing-enabled history retains the complete JSON result.

no_cacheboolean nullable

Accepted for compatibility. Searches are always fetched without a result cache for either value; normal successful-request billing applies.

Example request

{
  "json_restrictor": "results[].{title,url},has_next_page,next_page_token"
}

Response

Request completed. One credit is charged, including recognized empty or unavailable source results and source inventory changes discovered after a valid continuation is fetched. These completed responses may preserve verified partial results; operational failures remain errors.

successtrue required
request_idstring uuid required

Changes

No recorded changes to this operation across all 2 revisions of this API.