Google Shopping Scraper API

Google Shopping loads results through async AJAX calls, requires hidden backend parameters for full detail extraction, and has aggressive bot detection that blocks requests-level HTTP clients. Scraping it directly means headless browsers, session management, parameter reverse-engineering, and proxy rotation. This API handles all of that and returns parsed JSON. 40 products per page with prices, retailers, ratings, delivery info, and filters, ready to use.

Up to 40 products in shopping_results, plus Google's editorial category groupings in categorized_shopping_results (each with its own product list). A typical q=laptop response returns 40 main products + 5 category groups of 4-5 products each = ~60-65 total products per request.

First-class parameters for the common cases: min_price=500&max_price=1500, sort_by=1 (low-to-high) or sort_by=2 (high-to-low), free_shipping=true, on_sale=true. They combine freely and take precedence over the opaque shoprs token when both are set.

Every response returns 18+ filter groups in filters[] (Features, Screen Size, Price, Brand, CPU, RAM, Storage, OS, Condition, Seller, etc.), plus horizontal filter chips in carousel_filters[]. Each option carries an opaque shoprs token. Pass that token back as the shoprs query parameter to apply that filter on the next call. Chain filters by reading fresh shoprs values from each response.

Yes. gl=de&google_domain=google.de&hl=de pulls from the German Shopping catalog with German retailers, EUR pricing, and German UI. Same pattern works for 240+ country codes and 84 Google domains. For city-level targeting (e.g., local-inventory results), add location=Berlin,Berlin,Germany or a pre-encoded uule.

Either. The response carries thumbnail and source_icon as a valid image source, which may be a base64 data URI (data:image/webp;base64,...) or a regular URL (https://...). Both render directly in an <img src> without modification. Clients must handle both formats transparently.

The response includes pagination.next, a relative path like /plugin/google/shopping?q=laptop&start=10. Follow the link, appending your token. Keep going until pagination is absent. The top-level shopping_results carries up to 40 items per page, but the next link advances start by 10. Follow the returned value rather than assuming a fixed increment.

These are transient. Google occasionally returns an empty data shell on deeper paginated pages. Retry the same request once and it almost always succeeds. Only treat repeated empty responses as the actual end of the result set.

device=desktop (default) returns the desktop Shopping layout; device=mobile returns mobile. Mobile has a slightly different filter set and smaller thumbnails. Useful if you're tracking how listings appear across devices for the same query.

Yes. Queries that include "used" or "refurbished" surface second-hand items automatically, and those results carry a second_hand_condition field with one of "Refurbished", "Used", or "Renewed". You can also apply a Condition filter from the filters[] array.

The Google Shopping API documentation covers the full parameter list, response schema (including all shopping_results[] fields), filter groups, localization details, and the shoprs token mechanics.