# Google Shopping Lite API (`johnvc/google-shopping-lite-api`) Actor Search Google Shopping in bulk and get one row per product - price, retailer, rating, delivery, and link - for fast e-commerce price monitoring. Send many search terms at once, target a country and language. Pay per product. MCP-ready for Claude and AI agents. - **URL**: https://apify.com/johnvc/google-shopping-lite-api.md - **Developed by:** [John](https://apify.com/johnvc) (community) - **Categories:** E-commerce, SEO tools, Lead generation - **Stats:** 2 total users, 1 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 Lite | Bulk Product & Price API Fast, low-cost Google Shopping price data. Send one or many search terms and get one structured row per product - title, price, retailer, rating, delivery, and link. Built for bulk price monitoring and competitive intelligence at scale. Pay per product, with a flat headline price of **$1.50 per 1,000 products**. MCP-ready so Claude and other AI agents can call it as a tool. --- ### 📋 What this API returns One row per product, with these fields: | Field | Description | |---|---| | `title` | The product's display title. | | `price` | The listed price as shown, including the currency symbol (e.g. `$129.99`). | | `currency` | Currency of the price, when provided (e.g. `USD`). | | `source` | The retailer or seller offering the product (e.g. `Amazon.com`, `Best Buy`). | | `link` | URL to the product listing. | | `delivery` | Delivery or shipping note, when provided (e.g. `Free delivery`). | | `rating` | Average customer rating, when provided. | | `ratingCount` | Number of customer ratings, when provided. | | `productId` | The source's product identifier, when provided. | | `position`, `page` | Rank position within a result page, and which page it came from. | | `imageUrl` | Product thumbnail image URL, when the source provides a direct URL (inline base64 thumbnails are omitted to keep rows lean). | | `searchQuery` | The search term this product was returned for. | | `country`, `language` | The country and language used for the search. | --- ### 🎯 Use cases - **Bulk price monitoring.** Track prices for your whole catalog of search terms in one run, then schedule it to watch prices over time. - **Competitive intelligence.** See which retailers carry a product and at what price, side by side. - **Dropshipping research.** Scan many product ideas at once and compare prices, sellers, and ratings. - **SKU tracking.** Pull listings for specific products across sellers and export to JSON, CSV, or Excel. - **AI agent workflows.** Drive this API over MCP from Claude (see below) to pull live shopping prices in-conversation. --- ### ⚙️ Input examples #### One search term ```json { "searchTerms": ["wireless headphones"] } ```` #### Many search terms at once ```json { "searchTerms": ["wireless headphones", "noise cancelling earbuds", "mechanical keyboard"], "maxResultsPerSearch": 60 } ``` #### Country and language targeting ```json { "searchTerms": ["running shoes"], "country": "gb", "language": "en", "maxResultsPerSearch": 100 } ``` Each term is searched independently and paginated up to `maxResultsPerSearch` (default 100). Each page returns roughly 40 to 60 products. *** ### 📦 Example output ```json { "result_type": "product", "searchQuery": "wireless headphones", "title": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones", "price": "$329.99", "currency": "USD", "source": "Best Buy", "link": "https://www.bestbuy.com/site/...", "delivery": "Free delivery", "rating": 4.6, "ratingCount": 1842, "productId": "1234567890123456789", "position": 1, "page": 1, "imageUrl": "https://...", "country": "us", "language": "en", "fetched_at": "2026-05-29T00:00:00+00:00" } ``` *** ### 💰 Pricing (pay-per-event) | Event | Price | When it fires | |---|---|---| | `product` | $0.0015 | Per product returned and stored in the dataset. | That is a flat **$1.50 per 1,000 products**, with no setup fee. You pay only for the products actually stored. Examples: - One search term returning 60 products costs 60 x $0.0015 = **$0.09**. - Monitoring 100 products costs **$0.15**. - 1,000 products costs **$1.50**. If a run's budget cannot cover every requested product, the Actor caps output to stay within budget (it fills earlier search terms first), so you are never billed beyond your limit. *** ### 🆚 Need full product detail pages? This is the Lite tier: fast, SERP-grade price data, priced for bulk monitoring. It returns what Google Shopping shows on the results page. It does not open each product's detail page, pull full reviews, or track price history. If you need per-product detail pages, review pulls, or richer seller data, use the premium tier: [Google Shopping Products, Prices & Deals](https://apify.com/johnvc/google-shopping-search-scraper?fpr=9n7kx3). *** ### 🔌 Use this API from Claude (MCP) This Actor is MCP-server-compatible, so [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial), [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial), Claude (desktop and web), Cursor, and other MCP clients can call it as a tool through Apify's hosted MCP server. Add it with this Actor-specific URL: https://mcp.apify.com/?tools=actors,docs,johnvc/google-shopping-lite-api Setup walkthrough: https://www.youtube.com/watch?v=jREWahDGhJM Apify MCP integration docs: https://docs.apify.com/platform/integrations/mcp New to [Claude Code](https://claude.ai/referral/uIlpa7nPLg) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg)? Both have a free trial. Then ask Claude: > *"Use the Google Shopping Lite API to get prices for 'wireless headphones', and list the cheapest five with their retailers."* *** ### 🚀 How to get started 1. Open the Actor and enter one or more `searchTerms`. 2. Optionally set the country (`country`), language (`language`), and `maxResultsPerSearch`. 3. Run it and read the results from the dataset (JSON, CSV, Excel, or API). [View on Apify Store](https://apify.com/johnvc/google-shopping-lite-api?fpr=9n7kx3) *** ### ❓ FAQ **How many products do I get per search term?** As many as Google Shopping returns, up to your `maxResultsPerSearch` limit (default 100). Each results page carries roughly 40 to 60 products, and the Actor paginates until it reaches your limit or runs out. **How is billing calculated?** You pay $0.0015 per product stored, which is $1.50 per 1,000 products. There is no setup fee. If your run budget is smaller than the requested total, the Actor stores as many products as the budget covers (filling earlier search terms first) and stops. **Why did a run return fewer products than I asked for?** Either Google Shopping had fewer listings for that term, or the run budget capped the output. Raise the run's budget limit to store more. **Do I get product detail pages or reviews?** No. This Lite tier returns results-page data only. For detail pages and richer data, use the premium [Google Shopping Products, Prices & Deals](https://apify.com/johnvc/google-shopping-search-scraper?fpr=9n7kx3) Actor. *** Last Updated: 2026.06.01 # Actor input Schema ## `searchTerms` (type: `array`): Provide one or more product search terms to look up on Google Shopping (e.g. 'wireless headphones', 'noise cancelling earbuds'). Each term is searched independently and returns its own products. At least one term is required. ## `country` (type: `string`): Set the two-letter country code to localize prices and availability (ISO 3166-1, e.g. 'us', 'gb', 'de', 'ca'). Defaults to 'us'. ## `language` (type: `string`): Set the two-letter interface language code (ISO 639-1, e.g. 'en', 'de', 'fr'). Defaults to 'en'. ## `maxResultsPerSearch` (type: `integer`): Set the maximum number of products to return for each search term. The Actor paginates until it reaches this number or runs out of products. Each page returns roughly 40 to 60 products. Defaults to 100. ## Actor input object example ```json { "searchTerms": [ "wireless headphones", "noise cancelling earbuds" ], "country": "us", "language": "en", "maxResultsPerSearch": 100 } ``` # Actor output Schema ## `allResults` (type: `string`): Every dataset item from this run: product rows (result\_type='product') and any error rows. ## `overview` (type: `string`): Tabular overview of every product using the dataset schema's default view. Columns: product, price, retailer, rating, link, search. # 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 = { "searchTerms": [ "wireless headphones", "noise cancelling earbuds" ], "country": "us", "language": "en" }; // Run the Actor and wait for it to finish const run = await client.actor("johnvc/google-shopping-lite-api").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 = { "searchTerms": [ "wireless headphones", "noise cancelling earbuds", ], "country": "us", "language": "en", } # Run the Actor and wait for it to finish run = client.actor("johnvc/google-shopping-lite-api").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 '{ "searchTerms": [ "wireless headphones", "noise cancelling earbuds" ], "country": "us", "language": "en" }' | apify call johnvc/google-shopping-lite-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=johnvc/google-shopping-lite-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Shopping Lite API", "description": "Search Google Shopping in bulk and get one row per product - price, retailer, rating, delivery, and link - for fast e-commerce price monitoring. Send many search terms at once, target a country and language. Pay per product. MCP-ready for Claude and AI agents.", "version": "0.0", "x-build-id": "ooKmF7cmsLgwVyikO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-shopping-lite-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-shopping-lite-api", "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-lite-api/runs": { "post": { "operationId": "runs-sync-johnvc-google-shopping-lite-api", "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-lite-api/run-sync": { "post": { "operationId": "run-sync-johnvc-google-shopping-lite-api", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search Terms", "type": "array", "description": "Provide one or more product search terms to look up on Google Shopping (e.g. 'wireless headphones', 'noise cancelling earbuds'). Each term is searched independently and returns its own products. At least one term is required.", "items": { "type": "string" } }, "country": { "title": "Country Code", "type": "string", "description": "Set the two-letter country code to localize prices and availability (ISO 3166-1, e.g. 'us', 'gb', 'de', 'ca'). Defaults to 'us'.", "default": "us" }, "language": { "title": "Language Code", "type": "string", "description": "Set the two-letter interface language code (ISO 639-1, e.g. 'en', 'de', 'fr'). Defaults to 'en'.", "default": "en" }, "maxResultsPerSearch": { "title": "Max Results Per Search Term", "minimum": 1, "type": "integer", "description": "Set the maximum number of products to return for each search term. The Actor paginates until it reaches this number or runs out of products. Each page returns roughly 40 to 60 products. Defaults to 100.", "default": 100 } } }, "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 } } } } } } } } } } ```