# Google Shopping API | Google Shopping Products, Prices & Deals (`johnvc/google-shopping-api-google-shopping-products-prices-deals`) Actor Scrape Google Shopping results: extract product listings, prices, ratings, sellers, delivery info, and discount tags. Filter by location, price range, sort order, free shipping, and sale items. Supports multi-page scraping. Extract product listings, prices, ratings, sellers, and delivery info. - **URL**: https://apify.com/johnvc/google-shopping-api-google-shopping-products-prices-deals.md - **Developed by:** [John](https://apify.com/johnvc) (community) - **Categories:** E-commerce, SEO tools, Automation - **Stats:** 5 total users, 4 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.01 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 | Scrape Google Shopping Products, Prices & Deals Scrape Google Shopping like an API. Extract product listings, prices, ratings, sellers, delivery info, and discount tags for any search query. Filter by location, price range, sort order, free shipping, and sale items. Multi-page and international search supported. 🔗 **[View on Apify Store](https://apify.com/johnvc/google-shopping-search-scraper)** --- ### Quickstart 1. Click **Try for free** on the [Apify Store page](https://apify.com/johnvc/google-shopping-search-scraper) 2. Enter a search query in the **q** field (e.g., `wireless headphones`) 3. Click **Start** — results appear in the **Output** tab within seconds Or call it directly via the API: ```json { "q": "wireless headphones", "gl": "us", "hl": "en", "max_pages": 1 } ```` *** ### What This Actor Does The **Google Shopping Search Scraper** retrieves product listings from Google Shopping for any search query. For each product it returns: - **Title** and **product ID** - **Price** (display and extracted numeric value) - **Old price** / original price (for sale items) - **Source** (seller/retailer name) - **Rating** and **review count** - **Snippet** description - **Extensions** (badges like "Sponsored", sale labels) - **Delivery information** - **Thumbnail** image URL - **Product link** - **Installment payment details** (where available) - **Second-hand condition** (for used/refurbished listings) - **Multiple sources** (when a product is available from several sellers) You can filter results by price range, sort by price, and restrict to free-shipping or on-sale items only. *** ### Use Cases - **Price monitoring**: Track prices for products across retailers over time - **Competitive analysis**: See what sellers are offering a product and at what price - **Market research**: Identify trending products, discount patterns, and seller landscape - **E-commerce intelligence**: Monitor competitor pricing and promotions - **Price comparison tools**: Build tools that compare prices from different sources - **Deal finding**: Automatically find on-sale or free-shipping products *** ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `q` | string | **Yes** | — | Search query (e.g., "wireless headphones") | | `location` | string | No | — | Geographic location (e.g., "Austin, Texas, United States") | | `gl` | string | No | — | Country code (e.g., "us", "uk", "de") | | `hl` | string | No | — | Language code (e.g., "en", "es", "de") | | `google_domain` | string | No | google.com | Google domain (e.g., "google.co.uk") | | `device` | string | No | desktop | Device type: desktop, tablet, mobile | | `min_price` | number | No | — | Minimum price filter | | `max_price` | number | No | — | Maximum price filter | | `sort_by` | integer | No | — | 1 = price low→high, 2 = price high→low | | `free_shipping` | boolean | No | false | Only return free-shipping results | | `on_sale` | boolean | No | false | Only return on-sale results | | `max_pages` | integer | No | 1 | Pages to fetch. 0 = no limit. | | `output_file` | string | No | — | Optional filename to save results locally | *** ### Example Input **Basic search:** ```json { "q": "wireless headphones", "gl": "us", "hl": "en", "max_pages": 1 } ``` **Price-filtered search:** ```json { "q": "laptop", "min_price": 500, "max_price": 1200, "sort_by": 1, "gl": "us", "max_pages": 2 } ``` **Sale items with free shipping:** ```json { "q": "running shoes", "free_shipping": true, "on_sale": true, "gl": "us", "hl": "en", "max_pages": 1 } ``` **UK market search:** ```json { "q": "coffee machine", "location": "London, England, United Kingdom", "gl": "uk", "hl": "en", "google_domain": "google.co.uk", "max_pages": 1 } ``` *** ### Example Output Each dataset item represents one page of results: ```json { "search_parameters": { "q": "wireless headphones", "gl": "us", "hl": "en", "max_pages": 1 }, "search_metadata": { "results_count": 40, "pages_processed": 1, "max_pages_set": 1, "pagination_limit_reached": true }, "search_timestamp": "2026-05-07T14:30:00.123456", "page_number": 1, "shopping_results": [ { "position": 1, "title": "Sony WH-1000XM5 Wireless Headphones", "product_id": "1234567890", "product_link": "https://www.example.com/product/12345", "source": "Best Buy", "price": "$279.99", "extracted_price": 279.99, "old_price": "$349.99", "extracted_old_price": 349.99, "rating": 4.7, "reviews": 12483, "snippet": "Industry-leading noise cancellation with 30-hour battery life...", "extensions": ["20% off"], "delivery": "Free delivery", "tag": "Sale" } ], "filters": [...] } ``` *** ### Pricing This Actor uses **pay-per-event** billing: | Event | Cost | When charged | |-------|------|-------------| | Setup | $0.02 | Once per run | | Page processed | $0.02 | Per page of results (~40 products/page) | **Example costs:** - 1 page (~40 results): $0.04 total - 5 pages (~200 results): $0.12 total - 10 pages (~400 results): $0.22 total *** ### Pagination Google Shopping returns approximately **40 products per page**. Use `max_pages` to control how many pages are fetched: - `max_pages: 1` — fetch the first page only (default) - `max_pages: 5` — fetch up to 5 pages (~200 results) - `max_pages: 0` — fetch all available pages The Actor stops automatically when no more results are available. *** ### Notes - Results are localized based on `location`, `gl`, and `hl` parameters. For accurate local pricing, set all three. - The `filters` array is only included in the first page's dataset item. - Price filters (`min_price`, `max_price`) use the local currency of the targeted country. - The `sort_by` parameter changes the ordering but does not affect what products are available. *** ### Use with AI Agents (MCP) This Actor is discoverable and callable by AI agents via the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Connect `mcp.apify.com` to any MCP-compatible client (Claude, Cursor, etc.), then ask the agent to search Google Shopping — it will locate and call this Actor automatically. **Example agent prompt:** > "Search Google Shopping for wireless headphones under $200, sorted by price low to high, US only." The agent will find this Actor via `search-actors`, read its input schema, call it with the right parameters, and return structured product data — no manual setup required. *** ### FAQ **Q: How many results does each page return?**\ A: Approximately 40 products per page. Use `max_pages: 5` to get ~200 results. **Q: Can I search in other countries?**\ A: Yes. Set `gl` (country code), `hl` (language code), `location`, and `google_domain` together for accurate local results. Example: `gl: "uk"`, `hl: "en"`, `google_domain: "google.co.uk"`. **Q: What does `max_pages: 0` do?**\ A: Fetches all available pages until Google Shopping has no more results. Use with caution — some queries have hundreds of pages. **Q: Why do some products have an `old_price` field?**\ A: Google Shopping shows the original price alongside the discounted price for sale items. The `old_price` and `extracted_old_price` fields capture this. **Q: Can I filter to only show items on sale?**\ A: Yes — set `on_sale: true`. This filters to items Google Shopping has tagged as discounted. **Q: Why does the `filters` array only appear on the first page?**\ A: Google Shopping returns available filters (brand, price range, condition, etc.) with the first result page only. They are included in the first dataset item. *** Last Updated: 2026.05.12 # Actor input Schema ## `q` (type: `string`): The product or keyword to search for on Google Shopping. Example: 'wireless headphones', 'iPhone 15 case'. ## `location` (type: `string`): Geographic location to localize the search results. Example: 'Austin, Texas, United States', 'London, England, United Kingdom'. ## `gl` (type: `string`): Two-letter country code for Google to use. Examples: 'us', 'uk', 'de', 'fr', 'ca', 'au'. ## `hl` (type: `string`): Two-letter language code for results. Examples: 'en', 'es', 'de', 'fr', 'ja'. ## `google_domain` (type: `string`): Google domain to use for the search. Defaults to 'google.com'. Examples: 'google.co.uk', 'google.de', 'google.fr'. ## `device` (type: `string`): Device type to simulate. Different devices may return slightly different results and prices. ## `min_price` (type: `number`): Filter results to only show products above this price (in the local currency). ## `max_price` (type: `number`): Filter results to only show products below this price (in the local currency). ## `sort_by` (type: `integer`): Sort results by price. 1 = price low to high, 2 = price high to low. Leave blank for default relevance sorting. ## `free_shipping` (type: `boolean`): When enabled, only return products that offer free shipping. ## `on_sale` (type: `boolean`): When enabled, only return products that are currently on sale or have a discount. ## `max_pages` (type: `integer`): Maximum number of result pages to fetch. Each page contains approximately 40 products. Set to 0 for no limit (fetches all available pages). Default is 1. ## `output_file` (type: `string`): Optional filename for saving results as a JSON file locally. If not provided, a timestamped filename is generated automatically. ## Actor input object example ```json { "q": "wireless headphones", "device": "desktop", "free_shipping": false, "on_sale": false, "max_pages": 1 } ``` # Actor output Schema ## `allResults` (type: `string`): Complete dataset with all shopping results. Each item represents one page of results containing an array of product listings. ## `shoppingResults` (type: `string`): Product listings view showing page number, search parameters, metadata, and the shopping\_results array for each page. ## `searchSummary` (type: `string`): Search metadata including total results, pages processed, pagination status, and the parameters used. ## `filters` (type: `string`): Filter options returned by Google Shopping that can be used to refine search results. # 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 = { "q": "wireless headphones" }; // Run the Actor and wait for it to finish const run = await client.actor("johnvc/google-shopping-api-google-shopping-products-prices-deals").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 = { "q": "wireless headphones" } # Run the Actor and wait for it to finish run = client.actor("johnvc/google-shopping-api-google-shopping-products-prices-deals").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 '{ "q": "wireless headphones" }' | apify call johnvc/google-shopping-api-google-shopping-products-prices-deals --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=johnvc/google-shopping-api-google-shopping-products-prices-deals", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Shopping API | Google Shopping Products, Prices & Deals", "description": "Scrape Google Shopping results: extract product listings, prices, ratings, sellers, delivery info, and discount tags. Filter by location, price range, sort order, free shipping, and sale items. Supports multi-page scraping. Extract product listings, prices, ratings, sellers, and delivery info.", "version": "0.0", "x-build-id": "0yuFw7pdS9axy2O3z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-shopping-api-google-shopping-products-prices-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-shopping-api-google-shopping-products-prices-deals", "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/johnvc~google-shopping-api-google-shopping-products-prices-deals/runs": { "post": { "operationId": "runs-sync-johnvc-google-shopping-api-google-shopping-products-prices-deals", "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/johnvc~google-shopping-api-google-shopping-products-prices-deals/run-sync": { "post": { "operationId": "run-sync-johnvc-google-shopping-api-google-shopping-products-prices-deals", "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": [ "q" ], "properties": { "q": { "title": "Search Query", "type": "string", "description": "The product or keyword to search for on Google Shopping. Example: 'wireless headphones', 'iPhone 15 case'." }, "location": { "title": "Location", "type": "string", "description": "Geographic location to localize the search results. Example: 'Austin, Texas, United States', 'London, England, United Kingdom'." }, "gl": { "title": "Country Code (gl)", "type": "string", "description": "Two-letter country code for Google to use. Examples: 'us', 'uk', 'de', 'fr', 'ca', 'au'." }, "hl": { "title": "Language Code (hl)", "type": "string", "description": "Two-letter language code for results. Examples: 'en', 'es', 'de', 'fr', 'ja'." }, "google_domain": { "title": "Google Domain", "type": "string", "description": "Google domain to use for the search. Defaults to 'google.com'. Examples: 'google.co.uk', 'google.de', 'google.fr'." }, "device": { "title": "Device Type", "enum": [ "desktop", "tablet", "mobile" ], "type": "string", "description": "Device type to simulate. Different devices may return slightly different results and prices.", "default": "desktop" }, "min_price": { "title": "Minimum Price", "minimum": 0, "type": "number", "description": "Filter results to only show products above this price (in the local currency)." }, "max_price": { "title": "Maximum Price", "minimum": 0, "type": "number", "description": "Filter results to only show products below this price (in the local currency)." }, "sort_by": { "title": "Sort Order", "minimum": 1, "maximum": 2, "type": "integer", "description": "Sort results by price. 1 = price low to high, 2 = price high to low. Leave blank for default relevance sorting." }, "free_shipping": { "title": "Free Shipping Only", "type": "boolean", "description": "When enabled, only return products that offer free shipping.", "default": false }, "on_sale": { "title": "On Sale Only", "type": "boolean", "description": "When enabled, only return products that are currently on sale or have a discount.", "default": false }, "max_pages": { "title": "Max Pages", "minimum": 0, "type": "integer", "description": "Maximum number of result pages to fetch. Each page contains approximately 40 products. Set to 0 for no limit (fetches all available pages). Default is 1.", "default": 1 }, "output_file": { "title": "Output File Name", "type": "string", "description": "Optional filename for saving results as a JSON file locally. If not provided, a timestamped filename is generated automatically." } } }, "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 } } } } } } } } } } ```