{ "openapi": "3.0.1", "info": { "title": "Tiktok Video Scraper With Subtitles & Transcript", "description": "TikTok Video Scraper extracts TikTok videos with subtitles and transcripts, including captions, video details, creators, engagement metrics, hashtags, music, and URLs. Ideal for content research, SEO, competitor analysis, trend tracking, and audience insights.", "version": "0.1", "x-build-id": "fKByOExY5MODcBREd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~tiktok-video-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-tiktok-video-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/scrapio~tiktok-video-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-tiktok-video-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/scrapio~tiktok-video-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-tiktok-video-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": [ "postURLs" ], "properties": { "postURLs": { "title": "🎬 TikTok video URL(s) to transcribe", "type": "array", "description": "Paste the TikTok video links you want to scrape and caption. Enter them one per line, or upload/link a text file. Every video is returned with its full metadata; captions are read when the video has them.", "items": { "type": "string" } }, "extractTranscript": { "title": "📝 Read captions into a transcript", "type": "boolean", "description": "When on, the actor reads the video's WEBVTT caption track (loginless, no file downloaded) and flattens it into the `transcript` field. Turn off to return metadata only.", "default": true }, "subtitleLanguage": { "title": "🌐 Preferred caption language", "type": "string", "description": "Language code to prefer when a video has captions in several languages (e.g. `en`, `es`, `fr`, `de`, `ja`). The closest available track is picked; `availableSubtitleLanguages` lists everything the video offers.", "default": "en" }, "includeASR": { "title": "🎙️ Allow auto-generated (ASR) captions", "type": "boolean", "description": "When on, TikTok's auto speech-recognition captions are eligible (and used as a fallback). Turn off to accept only creator/human or machine-translated tracks — videos that only carry ASR captions then return no transcript.", "default": true }, "includeTimestamps": { "title": "⏱️ Include timed caption segments", "type": "boolean", "description": "When on, `transcriptSegments` is filled with `{start, end, text}` cues (seconds) parsed from the caption track, alongside the flat `transcript` text.", "default": false }, "scrapeRelatedVideos": { "title": "🔁 Also scrape related videos", "type": "boolean", "description": "Tick to additionally scrape TikTok's related videos for each URL (each is captioned too). The count is set by the field below. Note: TikTok typically limits related videos to 12-16 per video.", "default": false }, "resultsPerPage": { "title": "🔢 Related videos per URL", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "How many related videos to scrape per input URL. Only applies when related videos are enabled. TikTok typically caps this at 12-16 per video.", "default": 10 } } }, "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 } } } } } } } } } }