Google Shopping Product
Get a product's detail page — title, the stores/sellers offering it, prices, and related options — as JSON. Provide ONE identifier: catalog_id together with query for full details and stores (recommended), an immersive_product_page_token for full data, or product_id (which returns a limited response).
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsoncatalog_idstringDurable catalog id (from a Shopping result). Pass together with query to get full product details plus available stores.
Example: "7310953537322941042"
querystringRequired when catalog_id is set. The original shopping query.
Example: "wireless earbuds"
immersive_product_page_tokenstringToken from a Shopping result. Also returns full product data.
page_tokenstringAlias for immersive_product_page_token.
product_idstringProduct identifier. Returns a limited response on its own — prefer catalog_id + query.
sort_byenum<string>Seller sort order.
base_price— By item price.total_price— By price incl. shipping/tax.promotion— By promotion.seller_rating— By seller rating.
load_all_storesbooleanLoad all stores/sellers for the product.
more_storesbooleanInclude additional stores in the response.
deviceenum<string>default:desktopDevice to emulate.
desktop— Desktop.mobile— Mobile.tablet— Tablet.
glstringCountry of the search, ISO 3166-1 alpha-2.
Example: "us"
hlstringUI language, ISO 639-1.
Example: "en"
google_domainstringRegional Google domain to query.
Example: "google.com"
locationstringCanonical location name, auto-encoded to a UULE string.
uulestringPre-encoded UULE location string (takes priority over location).
Request
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
results = client.google.shopping_product(
catalog_id="7310953537322941042",
query="wireless earbuds",
)
print(results)Response