{ "openapi": "3.0.1", "info": { "title": "Target Scraper: Prices, Store Stock, Promotions & Tracking", "description": "Target.com (US) search results, category and product pages: price, regular price, sale type, promotions, rating, brand, TCIN, UPC, and the units in stock at stores near any ZIP. Every run shows what changed since your last one. No account needed.", "version": "0.1", "x-build-id": "pNHWMa7Aq0W5T4kzN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~target-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-target-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/zaiq~target-scraper/runs": { "post": { "operationId": "runs-sync-zaiq-target-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/zaiq~target-scraper/run-sync": { "post": { "operationId": "run-sync-zaiq-target-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": { "searches": { "title": "Searches", "type": "array", "description": "What to search Target for, one per line, or target.com search and category links.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Results per search", "minimum": 1, "maximum": 1200, "type": "integer", "description": "Target shows 24 products a page, up to 1,200 for a search.", "default": 24 }, "sort": { "title": "Sort", "enum": [ "relevance", "price_low", "price_high", "best_seller", "new", "rating_high" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "storeId": { "title": "Target store ID", "type": "string", "description": "Prices come from this store. Empty uses the store nearest your ZIP code, or store 3991." }, "zipCode": { "title": "ZIP code", "type": "string", "description": "A five-digit US ZIP, for example 55401. Prices come from the nearest store unless you give a Store ID, and store stock is checked around it." }, "includeSponsored": { "title": "Include sponsored results", "type": "boolean", "description": "Keep paid listings in the results (they are flagged).", "default": false }, "products": { "title": "Products", "type": "array", "description": "Target product links (target.com/p/.../-/A-...) or TCINs, one per line, read in full.", "items": { "type": "string" } }, "openProducts": { "title": "Open every search result in full", "type": "boolean", "description": "Also read each result's product page ($0.006 each).", "default": false }, "checkStock": { "title": "Check store stock", "type": "boolean", "description": "For every product, the units available and the in-store, pickup and curbside status at stores near your ZIP code. Charged per store checked.", "default": false }, "stockStores": { "title": "Stores to check per product", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many of the stores nearest your ZIP code.", "default": 5 }, "stockOnly": { "title": "Stock only for product links", "type": "boolean", "description": "For the Products list above, return only the store stock rows, not the product page. The cheapest way to watch stock of known products.", "default": false }, "trackPrices": { "title": "Track price changes", "type": "boolean", "description": "Compare every product with your last run: previous price, change and whether it is new. Free. Keeps one small key-value store in your Apify account.", "default": true }, "trackingName": { "title": "Tracking list name", "type": "string", "description": "Optional. Letters, numbers and hyphens. Give separate lists their own history, for example one per client." } } }, "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 } } } } } } } } } }