{ "openapi": "3.0.1", "info": { "title": "Bulk TikTok Transcripts Scraper | Captions, Subtitles, SRT", "description": "Extract bulk TikTok transcripts from captions at $0.50 per 1,000 videos on the free plan, less on paid plans, $0.0007 start fee. Video links, IDs or @profiles' latest videos; text, timestamped segments, SRT, views, likes. Linked videos without captions are free.", "version": "0.1", "x-build-id": "pMd2CjzoebqdgZG6k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aurelix~tiktok-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aurelix-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/aurelix~tiktok-transcript-scraper/runs": { "post": { "operationId": "runs-sync-aurelix-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/aurelix~tiktok-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-aurelix-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": { "videos": { "title": "Videos", "type": "array", "description": "TikTok video links or numeric video IDs, e.g. ['https://www.tiktok.com/@vicky.owens/video/7642780318604299542', '7642780318604299542']. Short share links (vm.tiktok.com, vt.tiktok.com, tiktok.com/t/...) and m.tiktok.com links work; several links pasted into one entry are split.", "items": { "type": "string" } }, "profiles": { "title": "Profiles (latest videos)", "type": "array", "description": "@usernames or profile links, e.g. ['@garyvee', 'https://www.tiktok.com/@bbcnews']. Reads the latest videos TikTok's public profile embed lists (about the 10 newest, plus pinned ones), newest first, up to 'Max videos per profile'. Each profile read costs one 'profile-checked' event.", "default": [], "items": { "type": "string" } }, "maxVideosPerProfile": { "title": "Max videos per profile", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many of each profile's latest videos to read, e.g. 5. TikTok's public profile embed lists about 10 recent videos, so higher values return what is there. Videos given directly are always read.", "default": 10 }, "languages": { "title": "Preferred languages", "type": "array", "description": "Caption languages in order of preference, as codes, e.g. ['en', 'es']. 'en' also matches eng-US. If none is available the video's own caption track is returned and 'language_fallback' is true. Empty = the video's own track (most TikTok videos have just one).", "default": [], "items": { "type": "string" } }, "includeAutoGenerated": { "title": "Include auto-generated captions", "type": "boolean", "description": "Use TikTok's automatic (speech recognition) captions when the creator added none; most TikTok captions are automatic. Off = only creator captions; other videos get a status row and are not charged.", "default": true }, "includeSegments": { "title": "Include timestamped segments", "type": "boolean", "description": "Add 'segments': every caption line with start and end in seconds, e.g. {start: 2.98, end: 6.38, text: '...'}. Off = plain text only, for smaller output.", "default": true }, "includeSrt": { "title": "Include an SRT subtitle file", "type": "boolean", "description": "Add 'srt': the captions as an SRT subtitle file in one text field, ready to save as .srt.", "default": false }, "incremental": { "title": "Only new videos since last run", "type": "boolean", "description": "Return only videos not returned by a previous run with the same inputs, e.g. for a daily schedule on a few profiles. A video without captions is tried again on the next run during its first day (TikTok adds automatic captions after upload).", "default": false }, "stateKey": { "title": "Incremental state name (optional)", "type": "string", "description": "Name for the 'new since last run' memory, e.g. 'my-creators-daily'. Leave empty to derive it from the inputs." }, "slackWebhookUrl": { "title": "Slack webhook URL (optional)", "type": "string", "description": "After each run, post a short digest to Slack: how many transcripts were saved (new ones only when 'Only new videos since last run' is on) and the top 10 with links, e.g. https://hooks.slack.com/services/T000/B000/XXXX. Nothing is posted when the run saved nothing. Leave empty to skip." }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "After each run, POST the same digest as JSON (actor, newOnly, count, items = top 10 results, runUrl, text) to any URL, e.g. a Zapier, Make or n8n webhook. Nothing is sent when the run saved nothing. Leave empty to skip." } } }, "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 } } } } } } } } } }