{ "openapi": "3.0.1", "info": { "title": "TikTok Shop Scraper | $10 per 1,000 products", "description": "[$10 / 1K] TikTok Shop products with the real published units-sold count, rating, review count, discount, variants, seller stats and the creator video bound to the card. Scrape by keyword, category or shop. No proxy setup, no captcha, no start fee.", "version": "0.1", "x-build-id": "j33SdCauPtqoOA91U" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdata_labs~tiktok-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdata_labs-tiktok-shop-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/webdata_labs~tiktok-shop-scraper/runs": { "post": { "operationId": "runs-sync-webdata_labs-tiktok-shop-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/webdata_labs~tiktok-shop-scraper/run-sync": { "post": { "operationId": "run-sync-webdata_labs-tiktok-shop-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": "Keywords", "type": "array", "description": "Product keywords to scrape, for example `wireless earbuds`. Each keyword returns the 25-30 products TikTok Shop ranks for it. Results are deduplicated across keywords, so overlapping terms never bill you twice for the same product. You can also paste a full `shop.tiktok.com/us/k/...` URL.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category pages", "type": "array", "description": "TikTok Shop category page URLs such as `https://shop.tiktok.com/us/c/headphones-earphones-accessories/601990`. A bare category id works too. Each category page returns 15 products.", "items": { "type": "string" } }, "shopUrls": { "title": "Shop pages", "type": "array", "description": "TikTok Shop seller page URLs such as `https://shop.tiktok.com/us/store/cmf-by-nothing/7495669706651568260`, or a bare seller id. Each shop page returns up to 30 products plus the shop's rating, follower count, total units sold and product count.", "items": { "type": "string" } }, "expandRelatedKeywords": { "title": "Follow related searches (levels)", "minimum": 0, "maximum": 3, "type": "integer", "description": "A single TikTok Shop keyword page serves 25-30 products and does not paginate, so following TikTok's own related-search links is how one keyword fills a larger run. Level 1 (the default) adds the roughly nine keyword pages TikTok links from yours; level 2 adds theirs. The walk stops early as soon as a level adds no product you do not already have. Set 0 to scrape only the exact keywords you listed.", "default": 1 }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Stop after this many unique products across every source. Set 0 for no cap. The default keeps a first run cheap and fast.", "default": 100 }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Keep only products at or above this price. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Keep only products at or below this price. Leave empty for no maximum." }, "minSoldCount": { "title": "Minimum units sold", "minimum": 0, "type": "integer", "description": "Keep only products with at least this many units sold. TikTok publishes the sold count on the card itself, so this is a measured number rather than an estimate. Useful for separating proven sellers from new listings.", "default": 0 }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Keep only products rated at or above this score out of 5. Products with no rating yet are excluded when this is set.", "default": 0 }, "onSaleOnly": { "title": "Discounted products only", "type": "boolean", "description": "Keep only products that carry a real original price and discount percentage from TikTok, not a computed one.", "default": false }, "withVideoOnly": { "title": "Products with a bound TikTok video only", "type": "boolean", "description": "Keep only products whose card is bound to a TikTok video, which is where the creator name, creator id, play count and like count come from. About a quarter of keyword-page products carry one. Category and shop pages never carry the video block, so this filter empties those two sources.", "default": false } } }, "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 } } } } } } } } } }