{ "openapi": "3.0.1", "info": { "title": "Google Shopping Scraper - Ads, Prices & Merchants", "description": "Updated 7 Aug 2026. Google Shopping scraper and API for the PAID Shopping ads on Google Search, not the organic tab. ~5s per keyword, 20x faster. 47 fields: price, merchantDomain, landingPage, ratings, delivery, promotions + each merchant's CSS. Price monitoring and competitor analysis. UK/EU/US.", "version": "1.0", "x-build-id": "IZt81ifokH1wOQICa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chris_coussons~google-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chris_coussons-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/chris_coussons~google-shopping-scraper/runs": { "post": { "operationId": "runs-sync-chris_coussons-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/chris_coussons~google-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-chris_coussons-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 keywords", "type": "array", "description": "Buyer keywords to check for paid Shopping ads, e.g. oak dining table", "items": { "type": "string" } }, "googleDomain": { "title": "Google domain", "type": "string", "description": "Which Google front end to search", "default": "www.google.co.uk" }, "countryCode": { "title": "Country code (gl)", "type": "string", "description": "Two letter country code for geo targeting", "default": "gb" }, "languageCode": { "title": "Language code (hl)", "type": "string", "description": "Two letter language code", "default": "en" }, "device": { "title": "Device", "enum": [ "desktop", "mobile" ], "type": "string", "description": "Which Google surface to scrape - desktop or mobile ads can differ", "default": "desktop" }, "location": { "title": "Local area (optional)", "type": "string", "description": "City or postal area for locally targeted Shopping ads", "default": "" }, "maxAdsPerQuery": { "title": "Max ads per keyword", "type": "integer", "description": "Cap on Shopping ads saved per keyword", "default": 40 }, "maxTotalAds": { "title": "Max total ads", "type": "integer", "description": "Overall cap across all keywords (0 = no cap)", "default": 0 }, "captureScreenshots": { "title": "Capture ad card screenshots", "type": "boolean", "description": "Save a PNG of each ad card - slower, useful for visual verification", "default": false }, "notifyEmail": { "title": "Alert email", "type": "string", "description": "Email to notify if a run fails badly. Leave blank for no alerts.", "default": "" }, "failureAlertThreshold": { "title": "Alert threshold (% failed)", "type": "integer", "description": "Send the alert when this share of keywords fails", "default": 25 }, "queriesPerSession": { "title": "Queries per browser session", "type": "integer", "description": "How many searches to run per solved session - higher amortises the captcha solve", "default": 8 }, "proxyType": { "title": "Proxy type", "enum": [ "RESIDENTIAL", "DATACENTER" ], "type": "string", "description": "RESIDENTIAL (fewer captchas, dearer) or DATACENTER (cheap, more solves)", "default": "RESIDENTIAL" }, "proxyCountry": { "title": "Residential proxy country", "type": "string", "description": "Country for the residential proxy exit node - should match the market being scraped", "default": "GB" }, "capsolverApiKey": { "title": "Bring your own captcha solver key (NOT REQUIRED - leave blank)", "type": "string", "description": "Leave this blank. Captcha solving is already included at no extra cost and needs no account from you. This field exists only for advanced users who want solves billed to their own CapSolver account instead." } } }, "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 } } } } } } } } } }