Search Google Shopping

litescrape.google.serp.shopping

Returns the Google Shopping product grid, category blocks, sponsored listings and refinement filters

Price: $0.00015/successAl precio del proveedor
Success rate: 9,9 %Last 30 days · 216.867 calls
Latency p50: 1.7 sp95 4.5 s
Last verified: 29 sept 2026Verified working

GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+makerPreview

Uses platform quota
Synchronous response
Reads public data

Parámetros

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Parámetros de consulta
`q`	cadena	Opcional	Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.	`coffee maker`
`gl`	cadena	Opcional	Two-letter country code used to localize results.	`us`
`hl`	cadena	Opcional	Language code such as en, en-GB, or de.	`en`
`num`	entero	Opcional	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.	`60`
`uule`	cadena	Opcional	Pre-encoded Google location token. Mutually exclusive with location.
`start`	entero	Opcional	Result offset.
`device`	cadena	Opcional	Google device layout. Each device is served Google's real layout for it.
`shoprs`	cadena	Opcional	Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
`on_sale`	booleano	Opcional	Show only products Google marks as on sale. Cannot be combined with another refinement.
`sort_by`	cadena	Opcional	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.
`timeout`	número	Opcional	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.
`location`	cadena	Opcional	Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.	`Austin, Texas`
`max_price`	número	Opcional	Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
`min_price`	número	Opcional	Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
`free_shipping`	booleano	Opcional	Show only products with free shipping. Cannot be combined with another refinement.
`google_domain`	cadena	Opcional	Google domain used for the request.	`google.com`
`small_business`	booleano	Opcional	Show only products from small businesses. Cannot be combined with another refinement.

Parámetros de consulta
qcadenaOpcional
Product search term, up to 2,048 characters. Required unless shoprs is supplied. This is a search, not an exact product ID lookup.
Ejemplo: coffee maker
glcadenaOpcional
Two-letter country code used to localize results.
Ejemplo: us
hlcadenaOpcional
Language code such as en, en-GB, or de.
Ejemplo: en
numenteroOpcional
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.
Ejemplo: 60
uulecadenaOpcional
Pre-encoded Google location token. Mutually exclusive with location.
startenteroOpcional
Result offset.
devicecadenaOpcional
Google device layout. Each device is served Google's real layout for it.
shoprscadenaOpcional
Refinement token from a previous response's filters. An explicit refinement parameter replaces the refinement it carries.
on_salebooleanoOpcional
Show only products Google marks as on sale. Cannot be combined with another refinement.
sort_bycadenaOpcional
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.
timeoutnúmeroOpcional
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.
locationcadenaOpcional
Human-readable search location, such as Austin, Texas. At most 63 UTF-8 bytes. Mutually exclusive with uule.
Ejemplo: Austin, Texas
max_pricenúmeroOpcional
Upper price bound in the storefront currency, at or above min_price. Cannot be combined with on_sale, free_shipping or small_business.
min_pricenúmeroOpcional
Lower price bound in the storefront currency. Cannot be combined with on_sale, free_shipping or small_business.
free_shippingbooleanoOpcional
Show only products with free shipping. Cannot be combined with another refinement.
google_domaincadenaOpcional
Google domain used for the request.
Ejemplo: google.com
small_businessbooleanoOpcional
Show only products from small businesses. Cannot be combined with another refinement.

Ejemplos de código

Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.shopping?q=coffee+maker", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.