{
"openapi": "3.0.1",
"info": {
"title": "Google Shopping Scraper",
"description": "[from $2.625/1K products] Scrape Google Shopping search results: product title, price, old price, discount, currency, seller, rating, ratings count, delivery, image, product URL. Many search terms and 45 countries per run. Add-on: every seller offer with total price and store link. No run fee.",
"version": "0.1",
"x-build-id": "mBsx5XMdAIuRjOMON"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/blueskyscraper~google-shopping-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-blueskyscraper-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/blueskyscraper~google-shopping-scraper/runs": {
"post": {
"operationId": "runs-sync-blueskyscraper-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/blueskyscraper~google-shopping-scraper/run-sync": {
"post": {
"operationId": "run-sync-blueskyscraper-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",
"properties": {
"queries": {
"title": "π Search terms",
"type": "array",
"description": "Enter one product search per line, exactly as you would type it into Google Shopping (e.g. wireless earbuds, iphone 16 case, nike air max 90). Every search term runs in every country below.",
"default": [
"wireless earbuds"
],
"items": {
"type": "string"
}
},
"countries": {
"title": "π Countries",
"type": "array",
"description": "Enter one country per line, by name or two-letter code (United States, US, United Kingdom, GB, Germany, DEβ¦). 45 Google Shopping countries are supported: Argentina, Australia, Austria, Belgium, Brazil, Canada, Chile, Colombia, Czechia, Denmark, Finland, France, Germany, Greece, Hungary, India, Indonesia, Ireland, Israel, Italy, Japan, Malaysia, Mexico, Netherlands, New Zealand, Norway, Philippines, Poland, Portugal, Romania, Saudi Arabia, Singapore, Slovakia, South Africa, South Korea, Spain, Sweden, Switzerland, Thailand, Turkiye, Ukraine, United Arab Emirates, United Kingdom, United States, Vietnam. Prices come in that country's currency.",
"default": [
"United States"
],
"items": {
"type": "string"
}
},
"maxProductsPerQuery": {
"title": "π― Max products per search",
"minimum": 1,
"maximum": 120,
"type": "integer",
"description": "Set how many products to return for each search term in each country (1β120). Google Shopping shows about 40 products per page; 40 is the natural size of one search.",
"default": 40
},
"language": {
"title": "π£οΈ Language",
"type": "string",
"description": "Optional: interface language for every country, by name or code (English, en, German, de, Spanish, esβ¦). Leave empty to use each country's main language (United States β English, Germany β German, Japan β Japanese)."
},
"sortBy": {
"title": "βοΈ Sort by",
"enum": [
"relevance",
"price_low_to_high",
"price_high_to_low",
"review_score"
],
"type": "string",
"description": "Order of the products of each search. Google Shopping no longer applies sorting reliably, so the Actor sorts the products it collected itself (the top N most relevant for your term): by price (products without a price last) or by rating. Position in the output follows this order.",
"default": "relevance"
},
"minPrice": {
"title": "Minimum price",
"minimum": 0,
"type": "integer",
"description": "Optional: only products priced at or above this amount, in the country's currency (whole number). Applied by Google Shopping itself."
},
"maxPrice": {
"title": "Maximum price",
"minimum": 0,
"type": "integer",
"description": "Optional: only products priced at or below this amount, in the country's currency (whole number). Applied by Google Shopping itself."
},
"includeSellerOffers": {
"title": "πͺ Add seller offers ($)",
"type": "boolean",
"description": "Switch on to add every store selling each product: store name, domain, direct product link, base price, shipping, tax, total price, condition, availability and store rating, plus the lowest total price. Up to 10 offers per product. Charged per product that has offers (see Pricing); products without offers are free.",
"default": false
},
"maxProductsWithOffers": {
"title": "Seller offers for top N products",
"minimum": 1,
"maximum": 120,
"type": "integer",
"description": "With seller offers on: fetch offers for the first N products of each search (1β120). Products below this position get no offers and no add-on charge.",
"default": 10
},
"includeCarouselProducts": {
"title": "Include carousel products",
"type": "boolean",
"description": "Switch on to also return products from Google Shopping's themed carousels (e.g. 'Deals on wireless earbuds', 'Budget picks'). Duplicates of products already in the results are removed; each row says which section it came from.",
"default": false
}
}
},
"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
}
}
}
}
}
}
}
}
}
}