{ "openapi": "3.0.1", "info": { "title": "Target Product Reviews Scraper", "description": "Scrapes Target product reviews from any product URL. Returns one flat row per review with rating, title, body, author, date, and verified-purchase flag. Filter by rating, verified status, or photo presence.", "version": "0.0", "x-build-id": "4W85q90kv0P5v9R0d" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~target-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-target-reviews-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/parseforge~target-reviews-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-target-reviews-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/parseforge~target-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-target-reviews-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": { "productUrls": { "title": "Target product URLs", "type": "array", "description": "List of Target product page URLs to scrape reviews from. Example: https://www.target.com/p/apple-airpods-pro-3/-/A-85978609", "items": { "type": "string" } }, "maxReviews": { "title": "Max Reviews", "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000." }, "sortBy": { "title": "Sort Reviews By", "enum": [ "most_recent", "most_helpful", "rating_desc", "rating_asc", "most_positive", "most_negative" ], "type": "string", "description": "How to sort the reviews.", "default": "most_recent" }, "filterByRating": { "title": "Filter by Rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return reviews with this star rating (1-5). Leave empty for all ratings." }, "verifiedOnly": { "title": "Verified Purchases Only", "type": "boolean", "description": "Only return reviews from verified purchasers.", "default": false }, "hasOnlyPhotos": { "title": "Reviews with Photos Only", "type": "boolean", "description": "Only return reviews that include photos.", "default": false }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of parallel requests. Lower this if you get rate-limited.", "default": 5 }, "requestDelayMs": { "title": "Request Delay (ms)", "minimum": 0, "type": "integer", "description": "Milliseconds to wait between requests. Increase if the site rate-limits you.", "default": 0 }, "includeProductDetails": { "title": "🏷️ Include product details", "type": "boolean", "description": "Adds a productDetails block to every review row: real product title, brand, UPC barcode, DPCI, category path, badges, highlights, specifications, description, images and videos. The current price, regular price and discount are included when Target returns them. It is one or two extra requests per product. Charged once per product, only for a product that returns it.", "default": false }, "includeReviewInsights": { "title": "📊 Include review insights", "type": "boolean", "description": "Adds a reviewInsights block to every review row (star distribution, recommended and not recommended counts, question count, feature score averages, topic sentiment) plus per review extras: isRecommended, modifiedAt, badges, photoUrls, videoUrls and brandResponses. It needs no extra request. Charged once per product, only for a product that returns it.", "default": false }, "includeQuestions": { "title": "❓ Include questions and answers", "type": "boolean", "description": "Also collects the product's shopper questions with every answer, as separate rows marked recordType \"question\". It is one extra request per 50 questions. Charged per question row delivered, and question rows are not billed as review results.", "default": false }, "maxQuestions": { "title": "Max questions per product", "minimum": 1, "type": "integer", "description": "Upper limit of question rows per product when \"Include questions and answers\" is on. Free users: limited to 100.", "default": 100 } } }, "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 } } } } } } } } } }