Google Search

Google Shopping

Returns the Google Shopping product grid, category blocks, sponsored listings and refinement filters. Google applies one refinement at a time, so min_price/max_price, on_sale, free_shipping and small_business are mutually exclusive; sort_by combines with any one of them. Each clustered product carries a litescrape_product_link to /api/google/shopping/product.

get/api/google/shopping

Request

  • Base URL: https://api.litescrape.com
  • URL: https://api.litescrape.com/api/google/shopping
  • Auth: one of:
    • HTTP bearer
    • API key in header zc-signature

Query parameters

qstring
Example:coffee maker

Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.

shoprsstring

Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.

min_pricenumber

Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.

max_pricenumber

Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.

sort_by'1' | '2' | '3' | '4'

Sort order: 1 price low to high, 2 price high to low, 3 rating high to low, 4 relevance (the default). Combines with any one refinement.

free_shippingboolean

Show only products with free shipping. Cannot be combined with another refinement.

on_saleboolean

Show only products Google marks as on sale. Cannot be combined with another refinement.

small_businessboolean

Show only products from small businesses. Cannot be combined with another refinement.

startinteger

Result offset.

numinteger
Example:60

Number of products to return. Google serves 40 products per page; a larger num reads further pages within the same call and returns fewer only when Google has no more products.

locationstring
Example:Austin, Texas

Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.

uulestring

Pre-encoded Google location token. Mutually exclusive with location.

google_domainstring
Example:google.com

Google domain used for the request.

glstring
Example:us

Two-letter country code used to localize results.

hlstring
Example:en

Language code such as en, en-GB, or de.

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

Google device layout. Each device is served Google's real layout for it.

timeoutnumber

Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.

Response

Successful response; one call consumed unless noted otherwise.

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.