# Google Shopping Scraper - Extract Prices, Sellers & Deals (`khadinakbar/google-shopping-scraper`) Actor Scrape Google Shopping: titles, prices, sellers, ratings, discounts & shipping. Multi-keyword search with 28 countries, sort by price or reviews, new/used/refurbished condition filters, and price range. Ideal for price monitoring, competitor research & e-commerce intelligence. - **URL**: https://apify.com/khadinakbar/google-shopping-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** E-commerce, Marketing, Lead generation - **Stats:** 5 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 product scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🛍️ Google Shopping Scraper Extract product listings, prices, sellers, ratings, discounts, and shipping info from Google Shopping in real time. Supports 28 countries, price range filters, sort by price or reviews, and new/used/refurbished condition filters. --- ### When to use this actor Use this actor when asked to: - Find prices for a product on Google Shopping - Compare prices across multiple sellers or merchants - Monitor or track product pricing over time - Research competitor pricing for a product category - Find the cheapest place to buy a specific product - Get product ratings and review counts from Google Shopping - Scrape Google Shopping results for a keyword or product name - Get localized prices in a specific country (UK, Germany, Japan, etc.) - Filter results by condition (new, used, refurbished) or price range --- ### Quick Start (Minimal Input) ```json { "searchQueries": ["wireless headphones"], "maxResults": 20 } ```` `searchQueries` is the only required field. All other fields have sensible defaults. *** ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchQueries` | string\[] | **required** | Product keywords to search. Multiple queries run independently. | | `maxResults` | integer | `20` | Max products per query (1–200). Triggers auto-pagination for higher values. | | `countryCode` | string | `"us"` | Target country for localized prices. E.g. `"gb"` for UK, `"de"` for Germany. | | `languageCode` | string | `"en"` | Language for results. E.g. `"fr"` for French. | | `sortBy` | string | `"relevance"` | Sort order: `relevance`, `price_low`, `price_high`, `review_score`. | | `condition` | string | `"any"` | Product condition: `any`, `new`, `used`, `refurbished`. | | `minPrice` | integer | — | Minimum price filter in the local currency (e.g. `50` = $50 in US). | | `maxPrice` | integer | — | Maximum price filter in the local currency (e.g. `500` = $500 in US). | | `proxyConfiguration` | object | GOOGLE\_SERP | Leave as default — GOOGLE\_SERP proxy is required for reliable Google access. | #### Example: Price comparison with filters ```json { "searchQueries": ["Sony WH-1000XM5", "Bose QuietComfort 45"], "maxResults": 10, "sortBy": "price_low", "condition": "new", "countryCode": "us" } ``` #### Example: UK price monitoring ```json { "searchQueries": ["iPad Pro 13 inch"], "maxResults": 20, "countryCode": "gb", "languageCode": "en" } ``` #### Example: Budget product research ```json { "searchQueries": ["gaming keyboard"], "maxResults": 40, "sortBy": "price_low", "minPrice": 30, "maxPrice": 150 } ``` *** ### Output Each item in the dataset represents one product listing. | Field | Type | Description | |-------|------|-------------| | `title` | string | Full product name as shown on Google Shopping | | `price` | number|null | Numeric price in local currency | | `price_raw` | string|null | Raw price string with currency symbol (e.g. `"$39.99"`) | | `currency` | string|null | Currency symbol (e.g. `"$"`, `"£"`, `"€"`) | | `original_price` | number|null | Pre-discount price if a sale is shown | | `discount_percent` | number|null | Calculated discount % when original price is available | | `merchant` | string|null | Seller name (e.g. `"Best Buy"`, `"Amazon"`) | | `rating` | number|null | Star rating out of 5.0 | | `reviews_count` | integer|null | Number of user reviews | | `product_url` | null | Always null — Google Shopping uses JS navigation (no static href) | | `image_url` | null | Always null — images are lazy-loaded via JS (not in static HTML) | | `shipping` | string|null | Shipping info (e.g. `"Free delivery by Wed"`) | | `condition` | string|null | Product condition if shown (`new`, `used`, `refurbished`) | | `position` | integer | 1-based rank in search results | | `search_query` | string | The original search query that returned this product | | `country` | string | Country code used for the search | | `scraped_at` | string | ISO 8601 timestamp | | `source_url` | string | The Google Shopping URL that was scraped | #### Example output item ```json { "title": "Sony WH-CH720N Noise Canceling Wireless Headphones", "price": 179.99, "price_raw": "$179.99", "currency": "$", "original_price": null, "discount_percent": null, "merchant": "Walmart", "rating": 4.6, "reviews_count": 14000, "product_url": null, "image_url": null, "shipping": "Free delivery by Tue", "condition": null, "position": 1, "search_query": "wireless headphones", "country": "us", "scraped_at": "2026-04-13T10:30:00.000Z", "source_url": "http://www.google.com/search?q=wireless+headphones&tbm=shop&gl=us&hl=en&num=40" } ``` *** ### Supported Countries `us` `gb` `ca` `au` `de` `fr` `es` `it` `br` `mx` `in` `jp` `nl` `pl` `se` `no` `dk` `fi` `be` `at` `ch` `pt` `ie` `nz` `za` `sg` `ae` `sa` *** ### Known Limitations - **`product_url` is always null** — Google Shopping renders product links via JavaScript. No static href is present in the HTML. - **`image_url` is always null** — Product images are lazy-loaded by JavaScript. The static HTML only contains placeholder GIFs. - **Price filters are approximate** — Google Shopping occasionally returns results slightly outside the min/max range. - **GOOGLE\_SERP proxy is required** — Do not change the proxy configuration or the actor will fail. *** ### Pricing Pay-Per-Result at **$0.002 per product** extracted. | Products scraped | Estimated cost | |-----------------|----------------| | 100 | ~$0.20 | | 1,000 | ~$2.00 | | 10,000 | ~$20.00 | *** ### Legal This actor scrapes publicly available data from Google Shopping. Users are responsible for ensuring their use complies with Google's Terms of Service and applicable laws. # Actor input Schema ## `searchQueries` (type: `array`): **REQUIRED.** Product keywords or phrases to search on Google Shopping (e.g. 'wireless headphones', 'iPhone 15 Pro', 'Sony WH-1000XM5'). Each query runs independently and returns up to maxResults products. Pass multiple queries to compare prices across products in one run. ## `maxResults` (type: `integer`): Maximum number of product listings to extract per search query. Higher values trigger automatic pagination. Min 1, max 200. ## `countryCode` (type: `string`): Target country for localized prices and results. Use 'us' for United States, 'gb' for UK, 'de' for Germany, etc. Controls the Google domain and gl parameter. ## `languageCode` (type: `string`): Language for search results (hl parameter). E.g. 'en' for English, 'de' for German, 'fr' for French. ## `sortBy` (type: `string`): How to sort Google Shopping results. 'relevance' returns Google's default ranking. 'price\_low' sorts cheapest first. 'price\_high' sorts most expensive first. 'review\_score' sorts by user rating. ## `condition` (type: `string`): Filter products by condition. 'any' returns all conditions. Use 'new', 'used', or 'refurbished' to narrow results. ## `minPrice` (type: `integer`): Minimum price filter in the target country's local currency. Leave empty for no minimum. E.g. 50 for $50 minimum in the US. ## `maxPrice` (type: `integer`): Maximum price filter in the target country's local currency. Leave empty for no maximum. E.g. 500 for $500 maximum in the US. ## `proxyConfiguration` (type: `object`): Leave as default. The GOOGLE\_SERP proxy group is required for this actor to work — changing this will cause all requests to fail. AI agents should not modify this field. ## Actor input object example ```json { "searchQueries": [ "wireless headphones" ], "maxResults": 20, "countryCode": "us", "languageCode": "en", "sortBy": "relevance", "condition": "any", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } ``` # Actor output Schema ## `results` (type: `string`): All product listings extracted from Google Shopping as structured JSON records # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "wireless headphones" ], "maxResults": 20, "countryCode": "us", "languageCode": "en", "sortBy": "relevance", "condition": "any", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/google-shopping-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["wireless headphones"], "maxResults": 20, "countryCode": "us", "languageCode": "en", "sortBy": "relevance", "condition": "any", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["GOOGLE_SERP"], }, } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/google-shopping-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "wireless headphones" ], "maxResults": 20, "countryCode": "us", "languageCode": "en", "sortBy": "relevance", "condition": "any", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } }' | apify call khadinakbar/google-shopping-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/google-shopping-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Shopping Scraper - Extract Prices, Sellers & Deals", "description": "Scrape Google Shopping: titles, prices, sellers, ratings, discounts & shipping. Multi-keyword search with 28 countries, sort by price or reviews, new/used/refurbished condition filters, and price range. Ideal for price monitoring, competitor research & e-commerce intelligence.", "version": "1.0", "x-build-id": "A3bEziJz5KiUPjuxr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~google-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-google-shopping-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/khadinakbar~google-shopping-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-google-shopping-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/khadinakbar~google-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-google-shopping-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "**REQUIRED.** Product keywords or phrases to search on Google Shopping (e.g. 'wireless headphones', 'iPhone 15 Pro', 'Sony WH-1000XM5'). Each query runs independently and returns up to maxResults products. Pass multiple queries to compare prices across products in one run.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results Per Query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of product listings to extract per search query. Higher values trigger automatic pagination. Min 1, max 200.", "default": 20 }, "countryCode": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "br", "mx", "in", "jp", "nl", "pl", "se", "no", "dk", "fi", "be", "at", "ch", "pt", "ie", "nz", "za", "sg", "ae", "sa" ], "type": "string", "description": "Target country for localized prices and results. Use 'us' for United States, 'gb' for UK, 'de' for Germany, etc. Controls the Google domain and gl parameter.", "default": "us" }, "languageCode": { "title": "Language", "enum": [ "en", "de", "fr", "es", "it", "pt", "nl", "pl", "sv", "no", "da", "fi", "ja", "zh", "ar" ], "type": "string", "description": "Language for search results (hl parameter). E.g. 'en' for English, 'de' for German, 'fr' for French.", "default": "en" }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "price_low", "price_high", "review_score" ], "type": "string", "description": "How to sort Google Shopping results. 'relevance' returns Google's default ranking. 'price_low' sorts cheapest first. 'price_high' sorts most expensive first. 'review_score' sorts by user rating.", "default": "relevance" }, "condition": { "title": "Product Condition", "enum": [ "any", "new", "used", "refurbished" ], "type": "string", "description": "Filter products by condition. 'any' returns all conditions. Use 'new', 'used', or 'refurbished' to narrow results.", "default": "any" }, "minPrice": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Minimum price filter in the target country's local currency. Leave empty for no minimum. E.g. 50 for $50 minimum in the US." }, "maxPrice": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Maximum price filter in the target country's local currency. Leave empty for no maximum. E.g. 500 for $500 maximum in the US." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Leave as default. The GOOGLE_SERP proxy group is required for this actor to work — changing this will cause all requests to fail. AI agents should not modify this field.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "GOOGLE_SERP" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```