{ "openapi": "3.0.1", "info": { "title": "TikTok Profile Videos API Scraper & Reposted Videos", "description": "TikTok Profile Videos API Scraper extracts video data from any TikTok profile, including captions, URLs, thumbnails, metrics, sounds, hashtags, and timestamps. Ideal for content analysis, trend tracking, monitoring creators, and automating high-quality, structured TikTok data collection", "version": "0.1", "x-build-id": "9miWdQ8w7uqLrapD2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~tiktok-profile-videos-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-tiktok-profile-videos-api-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/simpleapi~tiktok-profile-videos-api-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-tiktok-profile-videos-api-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/simpleapi~tiktok-profile-videos-api-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-tiktok-profile-videos-api-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "๐ŸŽฏ Creator profiles", "type": "array", "description": "TikTok profile URLs (https://www.tiktok.com/@username) or plain handles (mrbeast). One per line.", "items": { "type": "string" } }, "maxVideos": { "title": "๐ŸŽž๏ธ Own videos to scan per creator", "minimum": 0, "type": "integer", "description": "How many of the creator's OWN videos to read (captions are scanned for @-mentions). 0 = no cap. The feed returns 15 videos per request.", "default": 10 }, "includeReposts": { "title": "๐Ÿ” Read the Reposts tab", "type": "boolean", "description": "Fetch the videos this creator reposted. On a repost row the author / stats / video / music / url fields describe the ORIGINAL video โ€” the original creator is also copied into the original_creator_* fields.", "default": true }, "maxReposts": { "title": "๐Ÿ”ข Reposts to read per creator", "minimum": 0, "type": "integer", "description": "Cap on reposted videos per creator. 0 = read the whole Reposts tab (20 per request).", "default": 20 }, "onlyAmplificationRows": { "title": "๐Ÿงน Keep only rows that name another creator", "type": "boolean", "description": "Drop rows that neither repost anyone nor @-mention anyone, so the dataset is a clean partner shortlist.", "default": false }, "enrichAmplifiedCreators": { "title": "๐Ÿ‘ฅ Enrich every amplified creator", "type": "boolean", "description": "Look up each reposted / mentioned creator: follower, likes and video counts, bio text, bio link and business-account flag.", "default": true }, "maxEnrichedCreators": { "title": "๐Ÿ’ง Enrichment budget (distinct creators)", "minimum": 0, "type": "integer", "description": "Stop enriching after this many distinct handles in one run. 0 = no cap. Rows past the budget still carry the handles, just no profile card.", "default": 25 }, "sortOrder": { "title": "๐Ÿ•’ Own-video order", "enum": [ "newest", "oldest" ], "type": "string", "description": "TikTok's feed always serves newest-first. 'oldest' re-sorts the videos this run fetched, oldest first โ€” it does not reach further back in history.", "default": "newest" }, "proxyConfiguration": { "title": "๐ŸŒ Proxy", "type": "object", "description": "No proxy by default. If TikTok's WAF blocks the run, the actor escalates datacenter โ†’ residential automatically. Residential is the most reliable for the Reposts tab." } } }, "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 } } } } } } } } } }