{
"openapi": "3.0.1",
"info": {
"title": "Google Shopping Scraper",
"description": "Scrape Google Shopping: prices, discounts, stores, ratings, exact review counts, brands, images and product pages. 100+ products per search, no duplicates. Pay only per product.",
"version": "0.1",
"x-build-id": "nXKMXK6azQVB6yI99"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cornflower_vision~google-shopping-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cornflower_vision-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/cornflower_vision~google-shopping-scraper/runs": {
"post": {
"operationId": "runs-sync-cornflower_vision-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/cornflower_vision~google-shopping-scraper/run-sync": {
"post": {
"operationId": "run-sync-cornflower_vision-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": "Search queries",
"type": "array",
"description": "What you would type into Google Shopping, one per line, for example wireless earbuds or nike pegasus 41. Each query is searched separately.",
"items": {
"type": "string"
}
},
"maxProductsPerQuery": {
"title": "Max products per query",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "The first Google Shopping page has about 45-60 products; each further page has about 40 more. The Actor stops a query earlier when Google has no more products or new pages repeat the ones it already has.",
"default": 100
},
"country": {
"title": "Country",
"pattern": "^\\s*[a-zA-Z]{2}\\s*$",
"type": "string",
"description": "Two-letter country code of the market to search, for example us, gb, ca, au, de. Prices come in that country's currency.",
"default": "us"
},
"language": {
"title": "Language",
"pattern": "^\\s*[a-zA-Z]{2,3}(-[a-zA-Z]{2,4})?\\s*$",
"type": "string",
"description": "Language of the Google interface, for example en. Prices, stores and delivery are read from labels Google writes in English, so keep en for complete results.",
"default": "en"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "number",
"description": "Only products priced at least this much, in the currency of the country above (US dollars for us, pounds for gb...). The Actor uses Google's own price filter, so you get full pages of products in your range. Leave empty for no lower limit."
},
"maxPrice": {
"title": "Max price",
"minimum": 0.01,
"type": "number",
"description": "Only products priced at most this much, in the same currency. Leave empty for no upper limit. Products outside the range that Google still shows are left out, and you don't pay for them."
},
"skipForeignOffers": {
"title": "Skip offers from sellers abroad",
"type": "boolean",
"description": "Google also lists sellers in other countries, with a converted price and the original one in foreignPrice. Turn on to leave them out (you don't pay for skipped products).",
"default": false
},
"skipUsedProducts": {
"title": "Skip used and refurbished products",
"type": "boolean",
"description": "Leave out products marked Pre-owned, Refurbished or Used (you don't pay for skipped products).",
"default": false
},
"maxConcurrency": {
"title": "Pages at the same time",
"minimum": 1,
"maximum": 20,
"type": "integer",
"description": "How many Google Shopping pages are fetched in parallel. With 256 MB of memory (the default) at most 8 are; give the run more memory for more.",
"default": 5
}
}
},
"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
}
}
}
}
}
}
}
}
}
}