{ "openapi": "3.0.1", "info": { "title": "TikTok Transcript Scraper", "description": "Get transcripts of public TikTok videos from links or a creator's newest videos. Output plain text, timed segments, SRT or VTT, with language choice and video stats. No login. Videos that can't be read get an error code and aren't charged. You pay per video with a transcript.", "version": "0.1", "x-build-id": "px7tor6q1CUw4n9b7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zovo-one~tiktok-transcripts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zovo-one-tiktok-transcripts", "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/zovo-one~tiktok-transcripts/runs": { "post": { "operationId": "runs-sync-zovo-one-tiktok-transcripts", "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/zovo-one~tiktok-transcripts/run-sync": { "post": { "operationId": "run-sync-zovo-one-tiktok-transcripts", "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": "Video URLs", "maxItems": 1000, "type": "array", "description": "TikTok video links, one per line, up to 1,000. Keep the sample link and click Start to see one real transcript ($0.001). Accepted: https://www.tiktok.com/@user/video/123..., short links (vm.tiktok.com/..., vt.tiktok.com/..., tiktok.com/t/...), embed links and bare video IDs. Duplicates are skipped and counted in OUTPUT. A line that can't be read gets a free INVALID_URL row and the rest still run. The sample is left out when you add profiles and it's the only line here.", "default": [ "https://www.tiktok.com/@tedtoks/video/7704416343474441502" ], "items": { "type": "string" } }, "profileUrls": { "title": "Profile URLs", "maxItems": 50, "type": "array", "description": "Creator profiles (https://www.tiktok.com/@user or just @user), up to 50. The newest videos on the creator's public embed page are read, up to 10 per profile. For older videos, paste their links above.", "default": [], "items": { "type": "string" } }, "videosPerProfile": { "title": "Newest videos per profile", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many of each profile's newest videos to read (1 to 10). TikTok's public embed page lists about 10.", "default": 5 }, "languages": { "title": "Languages", "maxItems": 10, "type": "array", "description": "Leave empty to get the video's own spoken language. Or enter codes such as en, es, pt-BR or eng-US (the region part is ignored), up to 10. zh is Mandarin, yue is Cantonese. Enter \"all\" for every language TikTok has for the video. A video without any of your languages gets a free LANGUAGE_NOT_AVAILABLE row that lists the languages it does have. One price per video, whatever the number of languages.", "default": [], "items": { "type": "string" } }, "formats": { "title": "Output formats", "uniqueItems": true, "type": "array", "description": "text = the whole transcript as one string. segments = a list of {start, end, text} in seconds. srt and vtt = subtitle files as strings. Pick as many as you like; the price per video stays the same.", "items": { "type": "string", "enum": [ "text", "segments", "srt", "vtt" ], "enumTitles": [ "Plain text", "Timed segments", "SRT subtitles", "WebVTT subtitles" ] }, "default": [ "text", "segments" ] }, "includeMetadata": { "title": "Include video details", "type": "boolean", "description": "Add the post description, upload date, duration, author, play/like/comment/share/save counts, hashtags and sound title to each row. They come from the same page, so they cost nothing extra.", "default": true }, "maxVideos": { "title": "Max videos per run", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many videos (video lines plus profile videos), 1 to 1,000. Raise it for big profile lists, for example 200 for 20 profiles with 10 videos each. Videos over the limit get a SKIPPED row and aren't charged.", "default": 100 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Off by default. Turn on Apify Proxy if TikTok blocks the requests (rows with BLOCKED, PAGE_CHANGED or PROFILE_RATE_LIMITED). Use the automatic (datacenter) groups or your own proxy URLs. The RESIDENTIAL group isn't supported and stops the run at the start.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }