{
"openapi": "3.0.1",
"info": {
"title": "Google Shopping Scraper - Price Comparison & UPC",
"description": "Compare Google Shopping prices by keyword, barcode (UPC/EAN/GTIN), product ID or URL. Every seller offer with price, shipping, total, condition and stock, plus min/max/typical price. Price monitoring flags price drops and new or removed sellers. 45 countries.",
"version": "1.0",
"x-build-id": "bHeXAwYLela6j3N2d"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/wrenfield-data~google-shopping-price-comparison/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-wrenfield-data-google-shopping-price-comparison",
"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/wrenfield-data~google-shopping-price-comparison/runs": {
"post": {
"operationId": "runs-sync-wrenfield-data-google-shopping-price-comparison",
"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/wrenfield-data~google-shopping-price-comparison/run-sync": {
"post": {
"operationId": "run-sync-wrenfield-data-google-shopping-price-comparison",
"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 queries",
"type": "array",
"description": "Product searches, exactly as you would type them into Google Shopping (e.g. air fryer, iphone 15 128gb). One product row per result, up to Max products per query. You can also paste a Google Shopping search URL.",
"items": {
"type": "string"
}
},
"gtins": {
"title": "Barcodes (UPC / EAN / GTIN)",
"type": "array",
"description": "Barcodes to look up, one per line: 12-digit UPC, 13-digit EAN, 14-digit GTIN or 8-digit EAN-8 (e.g. 025500304076). Each barcode is matched to its Google Shopping product and verified against independent web listings for that barcode. Barcodes that cannot be matched are listed as not_found and are free.",
"items": {
"type": "string"
}
},
"productIds": {
"title": "Google product IDs or Shopping URLs",
"type": "array",
"description": "Google Shopping product IDs (the productId from a previous run, e.g. 14870010698400265781) or Google Shopping product URLs (google.com/shopping/product/... or google.com/search?ibp=oshop&...prds=... links). Best for monitoring a fixed list of products.",
"items": {
"type": "string"
}
},
"country": {
"title": "Country",
"enum": [
"AU",
"CA",
"FR",
"DE",
"GB",
"US",
"AR",
"AT",
"BE",
"BR",
"CL",
"CO",
"CZ",
"DK",
"FI",
"GR",
"HU",
"IN",
"ID",
"IE",
"IL",
"IT",
"JP",
"MY",
"MX",
"NL",
"NZ",
"NO",
"PH",
"PL",
"PT",
"RO",
"SA",
"SG",
"SK",
"ZA",
"KR",
"ES",
"SE",
"CH",
"TH",
"TR",
"UA",
"AE",
"VN"
],
"type": "string",
"description": "Google Shopping country. Prices, sellers and currency are for this country.",
"default": "US"
},
"language": {
"title": "Language",
"type": "string",
"description": "Language code such as en, de, fr, es, pt-BR. Leave empty for the country's main language."
},
"location": {
"title": "City, region or postal code (optional)",
"type": "string",
"description": "Get local results for a place inside the country, e.g. 10001, Chicago, Bavaria or London,England,United Kingdom. Leave empty for the whole country."
},
"sort": {
"title": "Sort search results",
"enum": [
"relevance",
"price_low_to_high",
"price_high_to_low",
"review_score"
],
"type": "string",
"description": "Sort order for search queries (barcodes and product IDs are not affected).",
"default": "relevance"
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Only search results at or above this price (whole currency units)."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Only search results at or below this price (whole currency units)."
},
"condition": {
"title": "Condition",
"enum": [
"any",
"new",
"used"
],
"type": "string",
"description": "Filters seller offers by condition. For search results it removes or keeps products whose title says refurbished / renewed / used / pre-owned (best effort).",
"default": "any"
},
"maxProducts": {
"title": "Max products (total)",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum product rows for the whole run (barcodes and product IDs first, then search results). Duplicate products are skipped.",
"default": 100
},
"maxProductsPerQuery": {
"title": "Max products per search query",
"minimum": 1,
"maximum": 120,
"type": "integer",
"description": "How many results to take from each search query (Google Shopping returns up to about 120).",
"default": 40
},
"fetchOffers": {
"title": "Get all seller offers",
"type": "boolean",
"description": "For every product, get the seller offers (Compare prices list): seller, price, shipping, total, condition, availability, seller rating and offer URL. Also fills min/max/typical price and number of sellers. Turn off for a cheaper product-only scrape.",
"default": true
},
"maxOffersPerProduct": {
"title": "Max offers per product",
"minimum": 1,
"maximum": 100,
"type": "integer",
"description": "Maximum seller offers per product (Google lists up to about 100).",
"default": 20
},
"includeDetails": {
"title": "Product details for search results",
"type": "boolean",
"description": "Also get brand, description, all images, specifications and variants for each search result (adds the product-details event per product). Barcode and product ID lookups always include details.",
"default": false
},
"resolveOfferUrls": {
"title": "Resolve offer URLs to merchant pages",
"type": "boolean",
"description": "Turn Google redirect links into the direct merchant product URL (e.g. the walmart.com or target.com page). Off = keep Google's redirect link.",
"default": true
},
"monitoringStoreName": {
"title": "Price monitoring store name",
"type": "string",
"description": "Turn on price monitoring: give a name (e.g. my-price-watch). Each run is compared with the previous run that used the same name, country and language. Products get a priceMonitor object (price drop / increase, new and removed sellers) and offers get changeStatus. Removed sellers are added as free offer rows. Schedule the Actor to monitor prices daily."
},
"onlyChanges": {
"title": "Output only changes",
"type": "boolean",
"description": "With price monitoring on, skip products whose price and sellers did not change (they are not charged) and unchanged offers.",
"default": false
},
"minPriceChangePct": {
"title": "Ignore price changes smaller than (%)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Price changes below this percentage count as unchanged.",
"default": 0
}
}
},
"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
}
}
}
}
}
}
}
}
}
}