{ "openapi": "3.0.1", "info": { "title": "TikTok Shop Reviewer Lead List - Buyers, Profiles & Emails", "description": "Turn TikTok Shop product reviews into a lead list of real buyers: username, profile link, rating, review text, plus followers, bio and email.", "version": "1.0", "x-build-id": "hIHcv0d5gMFbWOmYj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/seemuapps~tiktok-shop-reviewer-lead-list/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-seemuapps-tiktok-shop-reviewer-lead-list", "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/seemuapps~tiktok-shop-reviewer-lead-list/runs": { "post": { "operationId": "runs-sync-seemuapps-tiktok-shop-reviewer-lead-list", "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/seemuapps~tiktok-shop-reviewer-lead-list/run-sync": { "post": { "operationId": "run-sync-seemuapps-tiktok-shop-reviewer-lead-list", "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": [ "productUrls" ], "properties": { "productUrls": { "title": "Product URLs", "type": "array", "description": "TikTok Shop product page URLs such as https://www.tiktok.com/shop/pdp/cat-nail-clipper/1731578642912612516, or just the numeric product ID. One per line (up to 200). Reviewers of several products are merged into one row.", "items": { "type": "string" } }, "region": { "title": "Shop region", "enum": [ "US", "GB", "DE", "FR", "IT", "ES", "IE", "MX", "BR", "JP", "ID", "MY", "PH", "SG", "TH", "VN" ], "type": "string", "description": "The TikTok Shop marketplace the products are sold in. United States is the most complete; other regions may return fewer reviews.", "default": "US" }, "maxReviewersPerProduct": { "title": "Max reviewers per product", "minimum": 0, "type": "integer", "description": "How many new unique reviewers to collect from each product. 0 = as many as possible (up to 10,000 per product per run; use Page ID to continue).", "default": 100 }, "minStars": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviewers who gave at least this many stars (1-5). Use 4 to find happy buyers.", "default": 1 }, "maxStars": { "title": "Maximum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only include reviewers who gave at most this many stars (1-5). Set to 2 to find unhappy buyers of a competitor's product.", "default": 5 }, "enrichProfiles": { "title": "Add profile stats and contact info", "type": "boolean", "description": "Look up each reviewer's TikTok profile and add followers, following, likes, video count, bio, verified badge, link in bio, websites and any email address in the bio. Charged per profile found.", "default": false }, "pageId": { "title": "Page ID (pagination)", "type": "string", "description": "Paste NEXT_PAGE_ID from the previous run's Key-value store to continue each product where that run stopped. Keep the same Product URLs list." } } }, "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 } } } } } } } } } }