Google Shopping API returning live product results as JSON: titles, prices, merchants, ratings, and review counts by country and language. Pay per request.
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. Returns organic products in results and sponsored offers in shopping_ads, including native destination and tracking URLs. Ad links are returned without being visited.
Send a query to the Google Shopping endpoint with a country, language, and page number. Organic products appear in data.content.results. Sponsored offers appear separately in data.content.shopping_ads, with titles, displayed prices, merchants, links, and available ratings and images. Sponsored offer IDs are merchant identifiers and cannot be used as Google product IDs.
Pass a product_id and the original query to the Google Shopping Product API to get merchant offers with price, currency, shipping, and availability, plus images, ratings, and specifications.
Run the same queries on a schedule to track which products and merchants appear for a search, how listed prices change, and how results differ by country, language, and device.
Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.
curl 'https://api.prismcrawl.com/v1/google/shopping' \
--request POST \
--header 'content-type: application/json' \
--header 'x-api-key: <PRISMCRAWL_API_KEY>' \
--data '{
"query": "coffee grinder"
}'| Parameter | Usage |
|---|---|
query | Text to search for on the selected service. |
country | Two-letter country or storefront code, such as us or gb. |
language | Provider-supported language code, such as en. |
page | One-based page number. |
device | Device presentation for the source request. desktop, mobile, tablet |
html | Return the encoded original response rather than parsed JSON. |
zero_trace | Do not archive source or parsed response artifacts. |
location | Location to search around, such as Austin, TX. |
coordinates | Latitude and longitude for location targeting. |
safe | Provider safe-search filtering. active, off |
uule | Encoded Google location; cannot be combined with location or coordinates. |
google_domain | Google country domain, such as google.com or google.co.uk. |
start | Source result offset, starting at zero. The provider determines page size. |
shoprs | Native Google filter token, or up to twenty tokens joined by ||. Supplies the query when query is omitted; named controls override corresponding filters. |
min_price | Lower price bound in the source country currency. Overrides the corresponding shoprs bound. |
max_price | Upper price bound in the source country currency. Overrides the corresponding shoprs bound. |
sort_by | Price sorting: 1 for low to high, 2 for high to low. Overrides shoprs sorting. 1, 2 |
free_shipping | Enable or disable the native free shipping filter, overriding shoprs. |
on_sale | Enable or disable the native on sale filter, overriding shoprs. |
small_business | Enable or disable the native small business filter, overriding shoprs. |
Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.
Sponsored offers appear separately in data.content.shopping_ads, with their position, merchant offer ID, title, price, merchant, destination and tracking URLs, and available delivery, rating, review, and image details. Organic products stay in results. Either array can be empty. Ad URLs may be Google redirects; returning them does not visit the advertiser. Missing optional fields retain their empty string or numeric zero values.
addresscategorycoordinatesdescriptionidimmersive_product_page_tokenlatitudelongitudemerchantnameoffer_labeloriginal_pricephonepositionpriceproduct_idrankratingrating_maxrating_sourcereview_countreviews_displaysnippetthumbnailtitletypeurlwebsiteThe official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.
pip install prismcrawlnpm install prismcrawlGoogle's Merchant API (formerly the Content API for Shopping) manages a merchant's own product data. It does not return the Shopping results people see for a query. PrismCrawl returns those results as JSON.
Take the product_id from a Shopping result and request the Google Shopping Product API with the same query. The response lists the merchant offers Google shows for that product.
Each completed Google Shopping request uses one credit. Credits cost $0.30–$0.15 per 1,000 depending on the package, with no subscription, and new accounts receive 100 free credits. Validation and operational errors are not charged.