# TikTok Transcript Scraper (`scrapebridge/tiktok-transcript-scraper`) Actor TikTok Transcript Scraper extracts captions, subtitles, and auto-generated transcripts from public TikTok videos. Ideal for content analysis, keyword research, trend tracking, accessibility, and marketing insights to better understand audience engagement and video performance. - **URL**: https://apify.com/scrapebridge/tiktok-transcript-scraper.md - **Developed by:** [Scrape Bridge](https://apify.com/scrapebridge) (community) - **Categories:** Social media, Videos, SEO tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.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 🎯 Scraping TikTok captions one video at a time is slow, error-prone, and hard to scale when you need real text for analysis or repurposing. **Tiktok Transcript Scraper** pulls transcripts and key video metadata from TikTok URLs in bulk so you can move faster with a TikTok captions scraper or TikTok subtitle scraper workflow. It’s perfect for marketers, data analysts, and researchers who want TikTok transcript extraction tool output ready for downstream cleanup, indexing, or research. In one run, you can process multiple TikTok video URLs and save structured results to your dataset within seconds of starting. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847", "id": "7506519006854253847", "description": "Building useful web tools—one tip at a time.", "created_time": 1717212345, "transcript": [ { "start": "00:00:00", "end_time": "00:00:02", "text": "Here’s a quick tip to improve your workflow." }, { "start": "00:00:02", "end_time": "00:00:05", "text": "Automate the boring parts and focus on results." } ], "video_height": "1920", "video_width": "1080", "video_duration": "00:00:45", "cover_url": "https://example.com/cover.jpg", "video_download_url": "https://example.com/download.mp4", "stats_play": [1234, 0], "authorStats": [ { "key": "followers", "value": 48200 } ], "status": "success" } ```` | Field | Type | What It Tells You | |---|---|---| | `url` | string | The TikTok video URL you provided—easy traceability back to the input. | | `id` | string | A stable video identifier for matching, deduping, and joins in your data pipeline. | | `description` | string | Video description text that often complements captions for topic modeling and tagging. | | `created_time` | number | When the video was created, useful for time-based analysis and trend comparisons. | | `transcript` | array | string | Parsed caption timing + text (or `"No Transcript Found"` when nothing is available). | | `video_height` | text | Video resolution height metadata for media analytics and quality checks. | | `video_width` | text | Video resolution width metadata for media analytics and quality checks. | | `video_duration` | text | Duration string to help normalize pacing and compare content length. | | `cover_url` | link | Cover image URL for previewing content in dashboards or reports. | | `video_download_url` | link | Download link for the video asset when you need it alongside the transcript. | | `stats_play` | array | “Play” statistics payload for performance context (e.g., for correlating text themes to engagement). | | `authorStats` | array | Creator-level stats payload to enrich your dataset with audience context. | | `status` | string | Run outcome at the record level; errors are handled so you can detect failed items cleanly. | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "startUrls": [ { "url": "https://www.tiktok.com/@david.webdeveloper/video/7506519006854253847" }, { "url": "https://www.tiktok.com/@example_user/video/1234567890123456789" } ], "proxyConfiguration": { "useApifyProxy": false } } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrls` | ✅ | A list of TikTok video URLs to scrape (you can submit one or many). | | `proxyConfiguration` | ⬜ | Proxy settings for the run to help with reliable access to TikTok content. | | ↳ `proxy support` | ⬜ | Set whether to route requests through Apify Proxy (defaults to `false` in the prefill). | *** ### What It Does Tiktok Transcript Scraper takes a list of TikTok video URLs and outputs structured transcript data plus video and author metadata. #### Extract TikTok transcripts with timing For each provided URL, it returns a `transcript` field containing parsed subtitle segments with `start`, `end_time`, and `text`. This format is designed to be easy to analyze for themes, segments, and pacing—useful when you’re building workflows like a TikTok subtitle scraper or TikTok captions scraper. #### Clean, integration-ready JSON output Each result includes `url`, `id`, `description`, `created_time`, and video metadata such as `video_height`, `video_width`, and `video_duration`. The output also includes media links like `cover_url` and `video_download_url`, plus performance-style fields such as `stats_play` and `authorStats`. #### Built-in proxy support for reliable scraping The actor lets you configure proxy behavior via `proxyConfiguration`. If the selected proxy is rejected by TikTok, a residential proxy is used as a fallback to keep your runs moving. #### Includes retries and fallbacks for resilience When fetching transcript data, it uses a retry approach (up to 3 retries). If a transcript can’t be parsed or no subtitles are available, the actor returns `"No Transcript Found"` in the `transcript` field instead of breaking your pipeline. #### Works well as a TikTok transcript extraction tool Because results are pushed per-video into the dataset, you can run large batches of TikTok video transcript downloader jobs and then export for analysis, reporting, or enrichment—without manually copy-pasting captions. Overall, Tiktok Transcript Scraper turns TikTok transcript API–style output into a ready-to-use dataset for your next step. *** ### Why Tiktok Transcript Scraper? There are plenty of ways to pull text from TikTok videos—here’s why Tiktok Transcript Scraper stands out. #### Structured transcripts, not raw blobs You get parsed caption segments with clear timing boundaries (`start` and `end_time`) and clean caption text (`text`). That makes TikTok caption extraction easier to plug into analysis, transcription review, or content research. #### Reliable bulk processing with proxy fallback If your initial proxy approach is rejected, the actor falls back to a residential proxy method to keep the run robust. This is especially helpful when you’re scraping captions from TikTok videos at scale. #### Results written directly to your dataset As each TikTok video is processed, the result is pushed to the dataset immediately. That means less waiting, better visibility, and easier partial-run recovery. *** ### Real-World Use Cases Here's how different teams put Tiktok Transcript Scraper to work: **Growth & Content Analysts**\ A marketing analyst collects a weekly set of TikTok captions scraper inputs to understand what messaging patterns correlate with performance. After the run, they export the dataset to analyze themes over time using `created_time`, and segment quotes using the transcript timing. **SEO & Research Teams**\ A researcher building a dataset of TikTok text from captions for qualitative coding runs TikTok subtitle scraper batches by video URL. They use `transcript` plus `description` to enrich each record, then attach the results to internal taxonomy. **Outreach & Community Builders**\ A community manager wants to identify talking points in creator content before reaching out. Using Tiktok closed captions scraper output, they quickly scan segments by timing and capture the exact caption wording alongside `authorStats` and `stats_play` context. **Automation & Data Engineers**\ A developer integrates a TikTok transcription scraper into an ETL pipeline: trigger the actor, then ingest the dataset into their warehouse. Because the output is consistent JSON with fields like `id`, `created_time`, and `video_download_url`, it’s straightforward to join with other content metadata. **Podcast & Repurposing Producers**\ A content team uses TikTok transcript extraction tool output to draft scripts and quotes. They pull `transcript` segments to preserve pacing, and fall back gracefully when `"No Transcript Found"` appears so their pipeline stays stable. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor on Apify**\ Go to the actor page on [console.apify.com](https://console.apify.com) and open **Tiktok Transcript Scraper**. 2. **Enter your inputs**\ Paste one or more TikTok video URLs into `startUrls` (each item should include a `url`). 3. **Configure proxy settings (optional)**\ If you have proxy preferences, set them under `proxyConfiguration` (for example `proxy support`). 4. **Start the run and watch the live log**\ Launch the run and monitor progress in the Apify log output. 5. **Open the Dataset tab**\ Your transcript results appear in the dataset as each video is processed. 6. **Export in your preferred format**\ Download your dataset as JSON, CSV, or Excel from the Apify dashboard. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Tiktok Transcript Scraper fits directly into your existing workflow. You can export results from the Apify dataset tab as JSON, CSV, or Excel for analysis and reporting. For automation, you can connect via Apify’s API access to pull results programmatically, or trigger downstream steps when a run completes using webhooks. No-code options like Zapier or Make can also help push extracted TikTok captions scraper output into your tools. If you already have dashboards, you can schedule repeated runs and keep your transcript dataset fresh for ongoing research and trend tracking. *** ### Pricing Tiktok Transcript Scraper runs on Apify, which includes a **free tier** — no credit card needed to start. You’ll begin with a limited amount of platform credits to run several test jobs and validate results quickly. After that, runs are billed based on Actor compute units (CU) with pay-as-you-go pricing, and Apify plans apply for larger workloads. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate-limit style failures | Uses multiple attempts (up to 3 retries). | | Proxy blocks | Supports proxy configuration and uses a residential proxy fallback when needed. | | Partial data availability | Returns `"No Transcript Found"` in `transcript` when subtitles aren’t available. | | Per-video dataset output | Pushes each successful result into the dataset as it’s processed. | | Parsing errors | Handles parsing issues by logging errors and returning `null` results for problematic items. | Limitations: this actor is designed for publicly accessible video transcript data. If a video has no subtitles/captions available, the `transcript` field will be `"No Transcript Found"`. Also, any login-gated content or restricted access scenarios are outside the scope of this actor. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes. Apify offers a free tier with credits you can use to run Tiktok Transcript Scraper and verify outputs before scaling up. #### Do I need to log in or create an account on TikTok? No. This actor works from publicly available TikTok video content you provide via `startUrls`, without requiring a TikTok account login. #### How accurate is the extracted data? The actor returns parsed transcript segments when subtitles/captions are available, and otherwise sets `transcript` to `"No Transcript Found"`. Accuracy depends on what captions exist on the target videos. #### How many results can I get per run? You can pass multiple items in `startUrls`. The actor processes the provided list and writes a result record per successfully scraped video into your dataset. #### How fresh is the data? The data freshness depends on when the captions exist on the target videos at the time you run the actor. Running again later will refresh the dataset for new or updated content. #### Is this legal? Does it comply with GDPR / CCPA? This actor is intended for **publicly available data**. You’re responsible for ensuring your use complies with GDPR, CCPA, and TikTok’s Terms of Service for your specific use case. #### Can I export to Google Sheets or Excel? Yes. You can export your dataset from the Apify dashboard as JSON, CSV, or Excel, and then import into Google Sheets or other tools that accept those formats. #### Can I schedule this to run automatically? Yes. You can schedule Apify actors for recurring runs so your TikTok captions scraper dataset stays up to date over time. #### Can I access results via the API? Yes. You can retrieve results programmatically using Apify’s API capabilities for this actor. #### What happens when the actor encounters an error? The actor logs errors and continues processing other URLs in your `startUrls`. If a transcript can’t be processed for a specific video, you may see `null` results for that item, while successful items are still pushed into the dataset. *** ### Get Help & Use Responsibly Got a question about Tiktok Transcript Scraper or a feature you'd like added? Reach out at . We welcome ideas like additional transcript formats, stronger dataset normalization fields, or export-friendly segment structures. **Disclaimer:** This actor collects **publicly available data** from TikTok. It does not access private accounts, login-gated pages, or password-protected content. You are responsible for ensuring your use complies with GDPR, CCPA, and TikTok’s Terms of Service. For data-removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # 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("scrapebridge/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("scrapebridge/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 scrapebridge/tiktok-transcript-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapebridge/tiktok-transcript-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Transcript Scraper", "description": "TikTok Transcript Scraper extracts captions, subtitles, and auto-generated transcripts from public TikTok videos. Ideal for content analysis, keyword research, trend tracking, accessibility, and marketing insights to better understand audience engagement and video performance.", "version": "0.1", "x-build-id": "lUeykiarMxTPfnluC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebridge~tiktok-transcript-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebridge-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/scrapebridge~tiktok-transcript-scraper/runs": { "post": { "operationId": "runs-sync-scrapebridge-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/scrapebridge~tiktok-transcript-scraper/run-sync": { "post": { "operationId": "run-sync-scrapebridge-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 } } } } } } } } } } ```