{ "openapi": "3.0.1", "info": { "title": "Google Shopping Scraper", "description": "Scrapes Google Shopping results for any search in 68 countries: title, price, old price, currency, store, rating, reviews, delivery, returns, thumbnail and product link, about 40 products per request, with price filters and optional offers from every store.", "version": "0.0", "x-build-id": "mifX22X9fGiQFV6G7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mina_safwat~google-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mina_safwat-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/mina_safwat~google-shopping-scraper/runs": { "post": { "operationId": "runs-sync-mina_safwat-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/mina_safwat~google-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-mina_safwat-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 words or Google Shopping links", "type": "array", "description": "One search per line. Type words as you would on Google Shopping (for example wireless earbuds), or paste the address of a Google Shopping results page: its search words, country, language and filters are used as they are. Entries that are not searches are listed in the FAILED_INPUTS record.", "items": { "type": "string" } }, "maxProductsPerQuery": { "title": "Max products per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Stops after this many products for each search (1 to 500). Each Google page holds about 40 products, and Google lists about 250-300 for a broad search, so very high numbers return everything Google has.", "default": 100 }, "countryCode": { "title": "Country", "type": "string", "description": "Two-letter code of the country whose Google Shopping you want: its stores, prices and currency, for example us, gb, de, fr, in or br. Supported: us, gb, ca, au, nz, ie, de, at, ch, fr, be, nl, lu, es, pt, it, gr, fi, ee, lv, lt, sk, si, hr, cy, mt, se, no, dk, pl, cz, hu, ro, bg, rs, ua, tr, il, ae, sa, qa, kw, bh, om, jo, ma, za, ng, in, pk, bd, lk, jp, kr, tw, hk, sg, my, th, vn, ph, id, mx, br, ar, cl, co, pe. A country in a pasted link (Google's gl parameter) takes the place of this for that link. Google does not offer Shopping everywhere (not in Egypt or Kenya, for example); a search Google answers without Shopping is listed in FAILED_INPUTS.", "default": "us" }, "languageCode": { "title": "Language", "type": "string", "description": "Interface language code (Google's hl parameter), for example en, de, fr or pt-BR. It changes the language of the labels Google writes itself, such as delivery and returns.", "default": "en" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Only products priced at least this much, in the country's currency. Leave empty for no lower limit." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Only products priced at most this much, in the country's currency. Leave empty for no upper limit." }, "includeOffers": { "title": "Include every store's offers", "type": "boolean", "description": "Also open each product's Google page and save the offers of up to 5 stores selling it (store, price, availability, delivery and the store's own link), plus the store link of the offer shown in the results as merchantUrl. It takes one more Google request per product, so runs are slower and each product with offers is charged an extra event. Products sold by one store only have no such page.", "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 } } } } } } } } } }