{ "openapi": "3.0.1", "info": { "title": "Target Product Search Scraper — Price & Stock Data", "description": "Search Target.com by keyword for current and regular prices, sale flags, stock, ratings, brands, images, and product URLs. Built for price monitoring, assortment research, and shopping agents—not review text or orders. Returns validated product rows. $0.007/product + usage.", "version": "1.0", "x-build-id": "zhtGKEX52B10Hxyp8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~target-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-target-product-search-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/khadinakbar~target-product-search-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-target-product-search-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/khadinakbar~target-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-target-product-search-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": { "searchQueries": { "title": "Target search queries", "type": "array", "description": "Use this when you need Target products matching one or more keywords. Enter 1-10 lines such as 'coffee maker' or 'wireless headphones'. The default is 'coffee maker'. This is not a Target product URL or TCIN lookup.", "items": { "type": "string" }, "default": [ "coffee maker" ] }, "maxResults": { "title": "Maximum products", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to cap the total products saved across all queries. Enter an integer from 1 to 500, for example 50. The default is 20 and event charges cannot exceed this count. This is not a per-query limit.", "default": 20 }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "newest" ], "type": "string", "description": "Use this to choose how Target orders each keyword search. Accepted values are relevance and newest. The default is relevance. This changes result order, not the price or stock filters.", "default": "relevance" }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Use this when paid placements should appear with organic Target results. Set true to retain sponsored products, for example during shelf-share research. The default is false. This does not identify Target Circle promotions.", "default": false }, "inStockOnly": { "title": "In-stock products only", "type": "boolean", "description": "Use this when the dataset should contain only products currently reported as available by the active Target search route. Set true to remove known out-of-stock records. The default is false. This does not guarantee future inventory or reserve an item.", "default": false }, "saleOnly": { "title": "Sale products only", "type": "boolean", "description": "Use this when only products with a current price below the regular price are useful. Set true for deal monitoring or markdown research. The default is false. This does not include coupon-only discounts when Target omits a lower current price.", "default": false }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Use this to remove products priced below a USD threshold. Enter a non-negative number such as 25. The default 0 disables the minimum-price filter. This is not a discount-percentage filter.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Use this to remove products priced above a USD threshold. Enter a non-negative number such as 100. The default 0 disables the maximum-price filter. This is not the run's event-charge cap.", "default": 0 }, "responseFormat": { "title": "Response detail", "enum": [ "concise", "detailed" ], "type": "string", "description": "Use concise for small AI-agent outputs or detailed for alternate images and bullet highlights. Accepted values are 'concise' and 'detailed'. The default is concise. This does not change product eligibility or pricing fields.", "default": "concise" } } }, "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 } } }, "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 } } } } } } } } } }