{ "openapi": "3.0.1", "info": { "title": "TikTok Transcript Scraper: Captions to Text, No Login", "description": "Get the transcript of any TikTok video from TikTok's own captions: plain text plus timed segments, language and caption source. Video links, share links, ids or a creator's latest videos. Videos without captions are free. No login, no speech to text fees.", "version": "0.1", "x-build-id": "9wSGdZeTycXDCO7k1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~tiktok-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-tiktok-transcript-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/themineworks~tiktok-transcript-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-tiktok-transcript-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/themineworks~tiktok-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-tiktok-transcript-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": { "videoUrls": { "title": "TikTok video URLs", "type": "array", "description": "The videos whose transcripts you want, one per line. Any of these forms works: https://www.tiktok.com/@mrbeast/video/7625263096117857567, a share link from the app (https://vm.tiktok.com/ZM.../ or https://www.tiktok.com/t/ZT.../), or just the video id 7625263096117857567. A profile link (https://www.tiktok.com/@garyvee) is read as a profile. Up to 1,000 links per run; the same video given twice is read once.", "items": { "type": "string" } }, "profiles": { "title": "TikTok profiles (latest videos)", "type": "array", "description": "Optional. Usernames (garyvee or @garyvee) or profile links. The actor reads each creator's latest videos, newest first, up to maxVideosPerProfile, and returns a transcript for every one that has captions. Up to 100 profiles per run.", "items": { "type": "string" } }, "maxVideosPerProfile": { "title": "Videos per profile", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many of each profile's latest videos to check, 1 to 500. Videos without captions count toward this number but are not charged. Example: 30.", "default": 10 }, "language": { "title": "Caption language (optional)", "type": "string", "description": "Leave blank to get the captions in the language spoken in the video. Or give a language code such as en, es, fr or eng-US: when TikTok offers a caption track in that language (often a machine translation), it is used instead. When it does not, the original captions are returned and requested_language_found is false." }, "includeSegments": { "title": "Timed segments", "type": "boolean", "description": "Add segments: every caption line with its start and end time in seconds. Turn off if you only need the plain text transcript.", "default": true }, "includeSubtitleFiles": { "title": "Subtitle files (VTT and SRT)", "type": "boolean", "description": "Add the captions as a WebVTT file (vtt, exactly as TikTok serves it) and an SRT file (srt) in each row, ready to save as .vtt or .srt.", "default": false }, "includeNoCaptionRows": { "title": "Rows for videos without captions", "type": "boolean", "description": "Add a free row (status no_captions, with the reason) for each video TikTok has no captions for, so you can see which videos had no speech. These rows are never charged. Turn off to get transcript rows only.", "default": true }, "residentialFallback": { "title": "Retry blocked requests on a residential IP", "type": "boolean", "description": "Leave on. When TikTok refuses a request from a datacenter IP twice, try once more from a residential IP before giving up on that video. This never changes what you pay.", "default": true } } }, "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 } } } } } } } } } }