{ "openapi": "3.0.1", "info": { "title": "Target Product Scraper | Prices Stock Reviews", "description": "Scrape Target.com US products by keyword, category, brand or TCIN. Extract prices, ratings, reviews, DPCI, images, store stock & fulfillment. Export Excel/CSV/JSON. Unofficial — not affiliated with Target.", "version": "0.1", "x-build-id": "VrkDspnGssEwsPGna" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~target-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-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/lentic_clockss~target-scraper/runs": { "post": { "operationId": "runs-sync-lentic_clockss-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/lentic_clockss~target-scraper/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-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": { "mode": { "title": "Mode", "enum": [ "keywordSearch", "categoryBrowse", "brandBrowse", "productDetail", "storeLocations", "taxonomyBrowse", "categoryTree", "aislesSearch", "productReviews", "productSummaries", "autocomplete", "findsPosts", "circleMembership", "itemDetail", "threeDimensional" ], "type": "string", "description": "Scrape mode.", "default": "keywordSearch" }, "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword.", "default": "paper towels" }, "query": { "title": "Query alias", "type": "string", "description": "Alias of keyword." }, "categoryId": { "title": "Category ID", "type": "string", "description": "N-id without prefix (e.g. 5xtg6)." }, "categoryUrl": { "title": "Category/Brand URL", "type": "string", "description": "Full /c/ or /b/ URL." }, "categorySlug": { "title": "Category slug", "type": "string", "description": "HTML slug hint." }, "brandId": { "title": "Brand ID", "type": "string", "description": "Brand N-id for brandBrowse." }, "brandSlug": { "title": "Brand slug", "type": "string", "description": "Brand path slug (e.g. apple)." }, "tcin": { "title": "TCIN", "type": "string", "description": "Product TCIN." }, "tcins": { "title": "TCINs", "type": "array", "description": "Batch TCINs for productSummaries.", "items": { "type": "string" } }, "productUrl": { "title": "Product URL", "type": "string", "description": "Full PDP URL." }, "preselectTcin": { "title": "Preselect child TCIN", "type": "string", "description": "Child variant TCIN." }, "zip": { "title": "ZIP", "type": "string", "description": "Ship-to ZIP (price/stock context). Change it and leave Store ID at its default (1771) to price at the Target store nearest this ZIP.", "default": "52404" }, "storeId": { "title": "Store ID", "type": "string", "description": "Primary pricing_store_id. Left at the default 1771 with another ZIP, the store nearest the ZIP is used instead.", "default": "1771" }, "storeIds": { "title": "Store IDs", "type": "array", "description": "Additional store_ids for Redsky geo.", "items": { "type": "string" } }, "fulfillmentType": { "title": "Fulfillment filter", "enum": [ "any", "pickup", "same_day", "shipping", "shop_in_store" ], "type": "string", "description": "Maps to d_channel facet.", "default": "any" }, "facets": { "title": "Facets", "type": "array", "description": "Raw facet URLs e.g. d_deals:sale.", "items": { "type": "string" } }, "expandFacets": { "title": "Expand facets", "type": "boolean", "description": "Slice PLP by channel/deals facets.", "default": false }, "expandVariants": { "title": "Expand variants", "type": "boolean", "description": "Include children[] prices.", "default": true }, "includeVariantRows": { "title": "Emit variants as rows", "type": "boolean", "description": "Opt in to one separately billed row per child variant. Variant rows share the same ZIP and resolved pricing-store context as their parent.", "default": false }, "sortBy": { "title": "Sort", "enum": [ "relevance", "Featured", "PriceLow", "PriceHigh", "RatingHigh", "bestselling", "newest" ], "type": "string", "description": "PLP sort (mapped to sorting_algorithm).", "default": "relevance" }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum rows for each user input (for example, each TCIN in tcins; scalar modes have one input). The default is 70. Larger values are collected in parts of 70. All row types share each input's allowance, and the run stops at your maximum total charge. Free Apify plan: 200 rows per run and 10 runs.", "default": 70 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 25, "type": "integer", "description": "PLP pages (offset step 24).", "default": 1 }, "taxonomyDepth": { "title": "Taxonomy depth", "minimum": 1, "maximum": 4, "type": "integer", "description": "categoryTree recursion depth.", "default": 2 }, "enrichDetails": { "title": "Enrich with PDP", "type": "boolean", "description": "Default on.", "default": true }, "enrichLimit": { "title": "Enrich limit", "minimum": 0, "maximum": 20, "type": "integer", "description": "Max PDP enrich rows.", "default": 1 }, "includeFulfillment": { "title": "Include fulfillment", "type": "boolean", "description": "Attach fulfillment. Default on.", "default": true }, "maxReviews": { "title": "Max reviews", "minimum": 0, "maximum": 100, "type": "integer", "description": "For productReviews.", "default": 20 }, "workerBaseUrl": { "title": "Worker base URL override", "type": "string", "description": "Optional HTTPS Cloud Run override." } } }, "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 } } } } } } } } } }