Google

Google Shopping

Search Google Shopping for products — title, price, seller, rating, and product/catalog id — with price, sale, and sorting filters, as JSON.

POST/api/v2/google/shopping

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Search query (-> q).

Example: wireless earbuds

deviceenum<string>

SERP layout device: desktop or mobile.

startnumber

Result offset (follow pagination.next).

min_pricenumber

Minimum price filter.

max_pricenumber

Maximum price filter.

sort_byenum<int>

0 relevance, 1 price ascending, 2 price descending.

free_shippingboolean

Only items offering free shipping.

on_saleboolean

Only items currently on sale.

shoprsstring

Opaque filter token from filters[] / carousel_filters[].

hlstring

UI language.

Example: en

glstring

Country perspective.

Example: us

google_domainstring

Regional Google domain.

locationstring

Canonical location name (auto-UULE).

uulestring

Pre-encoded UULE.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.google.shopping("wireless earbuds")
print(results)

Response

"engine": "google_shopping",

"q": "wireless earbuds",

"google_domain": "google.com",

"hl": "en",

"gl": "us",

"device": "desktop",

"start": 0

"page_title": "wireless earbuds - Google Shopping",

"query_displayed": "wireless earbuds",

"total_results": 0,

"time_taken_displayed": 0,

"organic_results_state": "",

"shopping_results_state": "Results for exact spelling",

"results_for": "",

"country": "",

"city": ""

"current": 0,

"next": "/plugin/google/shopping?q=wireless+earbuds&start=10"

"credits_used": 1,

"credits_remaining": 49

}