# Tiktok Transcript Scraper (`solid-scraper/tiktok-transcript-scraper`) Actor ๐ŸŽฌ Tiktok Transcript Scraper extracts captions & full transcripts fastโ€”ideal for creators, researchers, and marketers. ๐Ÿ“ˆ Find, analyze, and repurpose trending content quickly with accurate text export. ๐Ÿš€ Perfect for social listening & content strategy. - **URL**: https://apify.com/solid-scraper/tiktok-transcript-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Social media, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Tiktok Transcript Scraper ๐Ÿ“ผ **Tiktok Transcript Scraper** is an Apify actor that helps you turn TikTok video captions into structured transcript data. If youโ€™re looking for a *tiktok transcript scraper* or a *download tiktok transcript* workflow, this tool automates transcript extraction from TikTok video URLs and saves the results into a datasetโ€”so you can analyze, search, and reuse video text at scale. Whether youโ€™re a marketer, researcher, or data analyst, a reliable *tiktok caption scraper* (including *tiktok subtitles download* style output) saves you hours of manual copy-pasting and cleanup. --- ### Why choose Tiktok Transcript Scraper? | Feature | Benefit | |---|---| | โœ… **All-in-one transcript extraction** | Scrapes TikTok video transcripts and organizes them into a consistent dataset output | | โœ… **Proxy fallback for reliability** | Uses built-in proxy support and can fall back when access is rejected | | โœ… **Resilient retries** | Includes retries and fallbacks for resilience during scraping | | โœ… **Structured output for captions** | Returns transcript segments with start/end timestamps and text | | โœ… **Scales across multiple URLs** | Processes each provided video URL in a single run | | โœ… **Dataset-ready results** | Saves output immediately so itโ€™s easy to export for downstream analysis | --- ### Key features - ๐Ÿ“Œ **Video URL support (batch-ready):** Accepts one or more TikTok video URLs via `startUrls` - ๐Ÿ•’ **Timestamped transcript segments:** Outputs caption text split into `start`, `end_time`, and `text` (when available) - ๐Ÿ›ก๏ธ **Proxy resilience & fallback:** Built-in proxy support for reliable scraping, including fallback behavior when needed - ๐Ÿ”„ **Retry logic for stability:** Attempts up to **3** times per method to improve success rates - ๐Ÿ“Š **Rich video metadata included:** Alongside transcripts, saves fields like `video_duration`, `cover_url`, and `stats_play` - ๐Ÿ’พ **Immediate dataset saving:** Each successful result is pushed to the actor dataset as itโ€™s processed - ๐Ÿงพ **Clear โ€œno transcriptโ€ handling:** When a transcript isnโ€™t found, the actor returns `transcript: "No Transcript Found"` --- ### Input Provide input via an `input.json` file. Example structure: ```json { "startUrls": [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" } ], "proxyConfiguration": { "useApifyProxy": false } } ```` #### Input Fields | Field | Required | Description | |---|---:|---| | `startUrls` | โœ… | An array of TikTok video URLs to scrape. Provide one or more items shaped like `{ "url": "..." }`. | | `proxyConfiguration` | โŒ | Proxy configuration for the scraper. If the selected proxy is rejected by TikTok, a residential proxy will be used as a fallback. | | `proxyConfiguration โ€ข proxy support` | โŒ | Set to `true` to enable Apify Proxy; set to `false` to allow fallback behavior (default is `false`). | *** ### Output The actor saves results to the **TikTok Video Transcript Data** dataset in JSON formatโ€”one item per processed TikTok video URL. Example output: ```json [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847", "id": "7506519006854253847", "description": "Example video description text", "created_time": 1710000000, "transcript": [ { "start": "00:00:01", "end_time": "00:00:03", "text": "First caption text" }, { "start": "00:00:03", "end_time": "00:00:05", "text": "Second caption text" } ], "video_height": "1080", "video_width": "1920", "video_duration": "00:00:12", "cover_url": "https://example.com/cover.jpg", "video_download_url": "https://example.com/video.mp4", "stats_play": [123, 456], "authorStats": [{ "key": "followers", "value": 1000 }], "error_message": null } ] ``` #### Output Fields | Field | Type | Description | |---|---|---| | `url` | string | The TikTok video URL that was scraped | | `id` | string | TikTok video ID from the returned data | | `description` | string | Video description (`data["desc"]`) | | `created_time` | number | Video creation time (`data["createTime"]`) | | `transcript` | array | string | Caption transcript segments with timestamps (or the string `No Transcript Found`) | | `video_height` | text | Video height (`data["video"]["height"]`) | | `video_width` | text | Video width (`data["video"]["width"]`) | | `video_duration` | text | Video duration (`data["video"]["duration"]`) | | `cover_url` | link | URL to the video cover (`data["video"]["cover"]`) | | `video_download_url` | link | URL to download the video (`data["video"]["downloadAddr"]`) | | `stats_play` | array | Play statistics from `data["statsV2"]` | | `authorStats` | array | Author statistics from `data["authorStatsV2"]` | | `error_message` | string | null | Present in failure-state discussions; errors are logged, and when no valid result is produced, the actor will not push a dataset item | > Note: When subtitles are available, `transcript` is parsed into items shaped like `{ "start", "end_time", "text" }`. If no subtitles are present, `transcript` is set to `"No Transcript Found"`. *** ### How to use Tiktok Transcript Scraper (via Apify Console) 1. **Open Apify Console**\ Log in at https://console.apify.com and open the Actors tab. 2. **Find the actor**\ Search for **Tiktok Transcript Scraper** and open the actor page. 3. **Go to the INPUT panel**\ Use the built-in form to add your TikTok video URLs in `startUrls`. 4. **Set proxy configuration (optional)**\ If needed, configure `proxyConfiguration`. You can use Apify Proxy via `proxy support`, and the actor supports fallback behavior when access is rejected. 5. **Start the run**\ Click **Run**. While it runs, watch the logsโ€”if requests fail, retries and fallbacks help improve resilience. 6. **Review results in OUTPUT**\ After completion, open the dataset **TikTok Video Transcript Data** and inspect the table view (including `transcript`, `video_duration`, and stats). 7. **Export your data**\ Export the dataset for analysis and workflows (JSON/CSV export is available from the dataset UI). No coding required โ€” get accurate results in minutes with **Tiktok Transcript Scraper**. *** ### Advanced features & SEO optimization - ๐Ÿ” **Engineered for transcript extraction workflows:** Perfect for *tiktok transcript scraper* and *tiktok caption scraper* use cases where you need captions as usable text (not just video pages). - ๐ŸŒ **Batch caption downloads from URLs:** Great for *tiktok subtitle scraper* and *tiktok auto captions scraper* workflows when you have many videos to process. - ๐Ÿง  **Timestamp-aware transcript parsing:** Helps when you want *tiktok subtitles download* outputs aligned with time-based segments. - ๐Ÿ” **Reliability-first scraping:** Includes retries and proxy fallback to improve success rate when access conditions change. *** ### Best use cases - ๐ŸŽฏ **Marketing analysts measuring messaging patterns:** Convert TikTok captions into transcripts to analyze themes and messaging across campaigns. - ๐Ÿ“š **Researchers studying public content:** Scrape *tiktok video transcript extraction* outputs to perform text analysis and qualitative coding. - ๐Ÿ—‚๏ธ **Content ops teams building searchable archives:** Turn captions into structured data for faster discovery and internal knowledge bases. - ๐Ÿค– **Developers integrating transcripts into pipelines:** Use the dataset to feed a *tiktok transcript api* style workflow (without building custom scraping logic). - ๐Ÿ“ˆ **Brand monitoring & competitive intelligence:** Pull *tiktok captions to text* for videos from specific creators or topics and compare language over time. - โœ‰๏ธ **Lead generation research workflows:** Use transcript data as supporting context for outreach research (e.g., summarizing topics discussed in videos). - ๐Ÿงช **Podcast-style repurposing and transcription QA:** Validate and reuse caption text for drafts, scripts, and *download tiktok transcript* projects. *** ### Technical specifications - **Supported Input Formats** - โœ… `startUrls`: an array of objects with `url` fields for TikTok video URLs - **Proxy Support** - โœ… Configurable via `proxyConfiguration` - โœ… Includes fallback to residential proxies if the selected proxy is rejected by TikTok - **Retry Mechanism** - โœ… Uses **up to 3 retries** (MAX\_RETRIES = 3) for resilience - **Dataset Structure** - โœ… Saves items with fields including: `url`, `id`, `description`, `created_time`, `transcript`, `video_height`, `video_width`, `video_duration`, `cover_url`, `video_download_url`, `stats_play`, `authorStats` - **Rate Limits & Performance** - โœ… Designed for reliable extraction with retries; actual throughput varies with access conditions and proxy latency - **Limitations** - โŒ If subtitles/transcripts arenโ€™t available in the returned data, `transcript` will be set to `"No Transcript Found"` - โŒ The actor only processes URLs provided in `startUrls` *** ### FAQ #### Can I use Tiktok Transcript Scraper to download TikTok captions as text? โœ… Yes. **Tiktok Transcript Scraper** extracts transcript/caption data and returns it as structured `transcript` output (timestamped segments when available), making it suitable for a *tiktok caption text extraction* workflow. #### What happens if a TikTok video doesnโ€™t have a transcript? โŒ If subtitles are not present in the returned data, the actor outputs `transcript: "No Transcript Found"` for that video. #### Do I need to write code to run this actor? โœ… No. You can run it directly in Apify Console by filling in `startUrls` and (optionally) `proxyConfiguration`. The dataset is generated automatically. #### Does this actor support proxy configuration? โœ… Yes. You can set `proxyConfiguration`, including `proxy support`. If the selected proxy is rejected by TikTok, a residential proxy will be used as a fallback. #### How reliable is the scraping process? โœ… Reliability is improved with retry behavior (up to **3** attempts) and built-in proxy fallback logic to handle access variability. #### What exact fields will I get in the dataset? โœ… Each dataset item includes fields such as `url`, `id`, `description`, `created_time`, `transcript`, `video_height`, `video_width`, `video_duration`, `cover_url`, `video_download_url`, `stats_play`, and `authorStats`. #### Can I export the results for analysis? โœ… Yes. After the run, open the **TikTok Video Transcript Data** dataset and export the results (for example, to JSON or CSV) from the dataset UI. #### Is it legal to use scraped transcripts? โœ… The tool collects information from **publicly available sources**, but itโ€™s still your responsibility to comply with applicable laws and platform terms (including GDPR/CCPA requirements where relevant). *** ### Support & feature requests Have questions or ideas to improve **Tiktok Transcript Scraper**? Weโ€™re happy to hear feedback. - ๐Ÿ’ก **Feature Requests:** Examples include CSV export enhancements, additional transcript formatting options (for example, changing segment structure), or better dataset field coverage to better support *tiktok transcript tool* workflows. - ๐Ÿ“ง **Contact:** Reach out via . Your feedback helps shape the roadmap for future improvements to this *tiktok transcript scraper* actor. *** *If you need a reliable way to extract and reuse TikTok captions at scale, **Tiktok Transcript Scraper** delivers structured transcript data ready for analysis and downstream workflows.* *** ### Disclaimer **This tool accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected content. You are responsible for ensuring your use complies with applicable laws (including GDPR/CCPA where relevant), spam regulations, and TikTok/platform terms. Use responsibly, ethically, and for legitimate purposes only. For data removal requests, contact . # Actor input Schema ## `startUrls` (type: `array`): Enter one or more TikTok video URLs (e.g., https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847). ## `proxyConfiguration` (type: `object`): Select proxies to be used by the scraper. If the selected proxy is rejected by TikTok, a residential proxy will be used as a fallback. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" } ], "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" } ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("solid-scraper/tiktok-transcript-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" }], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("solid-scraper/tiktok-transcript-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" } ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call solid-scraper/tiktok-transcript-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/tiktok-transcript-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tiktok Transcript Scraper", "description": "๐ŸŽฌ Tiktok Transcript Scraper extracts captions & full transcripts fastโ€”ideal for creators, researchers, and marketers. ๐Ÿ“ˆ Find, analyze, and repurpose trending content quickly with accurate text export. ๐Ÿš€ Perfect for social listening & content strategy.", "version": "0.1", "x-build-id": "3KuDDKpwUwTwdg9t5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~tiktok-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-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/solid-scraper~tiktok-transcript-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-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/solid-scraper~tiktok-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-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", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "TikTok Video URLs", "type": "array", "description": "Enter one or more TikTok video URLs (e.g., https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by the scraper. If the selected proxy is rejected by TikTok, a residential proxy will be used as a fallback." } } }, "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 } } } } } } } } } } ```