{ "openapi": "3.0.1", "info": { "title": "Google Shopping Scraper and Price Tracker", "description": "Scrape Google Shopping prices by product name, model or barcode: price, original price, store, condition, delivery, rating and reviews. Compare each store's price and track only price changes on a schedule. No login. $1.50 per 1,000 products plus $6 per 1,000 searches. Maintained by CleanScrape.", "version": "0.1", "x-build-id": "Q5bfARpdtd8zLYdtG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cleanscrape~google-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cleanscrape-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/cleanscrape~google-shopping-scraper/runs": { "post": { "operationId": "runs-sync-cleanscrape-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/cleanscrape~google-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-cleanscrape-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": [ "queries" ], "properties": { "queries": { "title": "Products to search", "type": "array", "description": "Product names, model numbers or barcodes (EAN/UPC), one per line, such as \"sony wh-1000xm5\" or \"lego 10316\". You can also paste a Google Shopping results link (its filters are kept) or a Google Shopping product link (its stores are read directly).", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "de", "at", "ch", "fr", "be", "nl", "es", "it", "pt", "se", "dk", "no", "fi", "pl", "cz", "in", "jp", "sg", "my", "ph", "br", "mx", "za", "ae", "sa", "tr" ], "type": "string", "description": "Which Google Shopping to search. Prices are in that country's currency.", "default": "us" }, "maxProductsPerSearch": { "title": "Products per search", "minimum": 1, "maximum": 60, "type": "integer", "description": "Most products to save per search. Google Shopping shows about 40 per search.", "default": 40 }, "condition": { "title": "Condition", "enum": [ "any", "new", "used" ], "type": "string", "description": "Keep only products in this condition.", "default": "any" }, "compareStores": { "title": "Compare stores", "type": "boolean", "description": "Open Google's product page for the top products and save every store listed there (price, stock, delivery, returns, store link) to the Stores table. Charged per product page.", "default": false }, "storesForTopProducts": { "title": "Products to compare stores for", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many products per search get their store list. Products Google sells at several stores go first, then Google's order.", "default": 5 }, "onlyNewOrChanged": { "title": "Only new products and price changes", "type": "boolean", "description": "For scheduled runs: save only products that are new for a search or whose price changed since the last run. The Searches table shows the lowest price against the last run.", "default": false }, "skipNewListings": { "title": "Skip new listings", "type": "boolean", "description": "With tracking: after the first run (which saves everything as the starting point), save only price changes, not listings seen for the first time. Google rotates marketplace listings (eBay sellers and the like) between runs, so this keeps scheduled runs to real price moves.", "default": false }, "watchName": { "title": "Tracking name", "type": "string", "description": "Optional. Runs with the same name share their history. Leave empty to use one history per set of searches." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }