{ "openapi": "3.0.1", "info": { "title": "Douyin 抖音 Transcripts Scraper - 50+ Languages, .srt + MP4", "description": "Extract timestamped transcripts and .srt 字幕 from any Douyin (抖音) video. Mandarin speech-to-text plus translation into 50 languages. Optionally save the source MP4 and cover image to your key-value store at no extra cost. 60+ metadata fields. Per-minute pricing, free tier.", "version": "0.0", "x-build-id": "hmDaI0sDVqSINJ9pc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~douyin-transcripts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-douyin-transcripts-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/zen-studio~douyin-transcripts-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-douyin-transcripts-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/zen-studio~douyin-transcripts-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-douyin-transcripts-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": [ "videoUrls" ], "properties": { "videoUrls": { "title": "Douyin video URLs", "maxItems": 5, "uniqueItems": true, "type": "array", "description": "One or more Douyin video URLs. Most URL forms work — paste the desktop URL, the mobile share link, the discovery-feed URL with ?modal_id=…, or even the entire app share text (the URL is extracted from any surrounding noise). Bare numeric IDs also work.", "items": { "type": "string" } }, "targetLanguage": { "title": "Output language", "enum": [ "zh", "en", "es", "hi", "ar", "pt", "ru", "ja", "de", "fr", "ko", "id", "tr", "it", "vi", "th", "pl", "nl", "bn", "ur", "fa", "uk", "ms", "tl", "bg", "ca", "cs", "da", "el", "et", "fi", "gu", "he", "hr", "hu", "is", "kn", "lt", "lv", "ml", "mr", "nb", "pa", "ro", "sk", "sl", "sr", "sv", "sw", "ta", "te" ], "type": "string", "description": "Language to deliver the transcript in. Pick zh for the original Mandarin (no translation, lowest cost). Any other choice runs an LLM translation pass. The list below covers 50 translation targets — the most-requested languages first, then the rest alphabetically.", "default": "zh" }, "shouldDownloadVideos": { "title": "📥 Also save the MP4 video", "type": "boolean", "description": "Save the original MP4 file for each video to your key-value store. Free — the actor already downloads the video to extract audio, so saving a copy is no extra work. Get the transcript and the source video in one run; no need to also run the Douyin Video Scraper.", "default": false }, "shouldDownloadCovers": { "title": "🖼️ Also save the cover image", "type": "boolean", "description": "Save each video's cover image (JPEG) to your key-value store. Free.", "default": false }, "outputSrt": { "title": "Also produce a subtitle file (.srt)", "type": "boolean", "description": "When enabled, a SubRip subtitle file is written to the run's key-value store. The dataset record then includes srtUrl.", "default": false }, "videoKvStoreName": { "title": "Custom key-value store name (videos & covers)", "type": "string", "description": "Save downloaded MP4s and cover images to a named, persistent key-value store instead of this run's default store. Useful for archiving (the named store survives forever; the default one is cleaned up 7 days after the run) and for combining downloads from many runs into one bucket.

Naming rules: lowercase letters, digits, and dashes only.

Common patterns:Browse and re-download anything you've saved at console.apify.com/storage/key-value.

Leave empty to use this run's default store. Has no effect when both Also save the MP4 video and Also save the cover image are off.", "default": "" }, "srtKvStoreName": { "title": "Custom key-value store name (SRT files)", "type": "string", "description": "Save generated SRT files to a named, persistent key-value store instead of this run's default store. Useful for archiving (the named store survives forever; the default one is cleaned up 7 days after the run) and for combining SRT files from many runs into one bucket.

Naming rules: lowercase letters, digits, and dashes only.

Common patterns:Browse and re-download anything you've saved at console.apify.com/storage/key-value.

Leave empty to use this run's default store. Has no effect when Also produce a subtitle file is off.", "default": "" } } }, "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 } } } } } } } } } }