# Facebook Video Transcript Extractor (`scrapebase/facebook-video-transcript-extractor`) Actor ✨ Facebook Video Transcript Extractor to extract transcripts from public videos quickly and at scale. Collect captions, timestamps, and spoken content with ease. Ideal for research, SEO, and content analysis. Features: ⚡ fast extraction • 📊 clean output • 🔍 insights • 🌍 scalable automation - **URL**: https://apify.com/scrapebase/facebook-video-transcript-extractor.md - **Developed by:** [ScrapeBase](https://apify.com/scrapebase) (community) - **Categories:** Videos, SEO tools, Social media - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## 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 ### Facebook Video Transcript Extractor Facebook Video Transcript Extractor is a purpose-built Apify actor that converts public Facebook videos into clean, searchable text. It solves the challenge of how to download Facebook video transcript data at scale by extracting captions/transcripts from video pages via Facebook’s GraphQL interface — ideal for marketers, developers, data analysts, and researchers who need to extract subtitles from Facebook videos and convert Facebook video to text reliably. With batch processing and smart proxy fallback, it enables automated, large-scale transcript collection that powers SEO, accessibility, and content analysis workflows. ### What data / output can you get? Below are the exact fields this actor writes to the dataset for each processed URL. You can export results from the Apify dataset in JSON or CSV for downstream analysis and automation. | Data type | Description | Example value | | --- | --- | --- | | url | Source Facebook video URL that was processed | https://www.facebook.com/mrbeast/videos/546259055092102 | | transcript | Extracted transcript text (cleaned, single line). May be null if none is present | This is your money. How much of it do you want? ... | | error | Error message if extraction fails or no transcript is found; null on success | No transcript found in the response | | timestamp | UNIX timestamp (seconds with fractions) when the item was processed | 1761496105.9149563 | Note: Results are pushed incrementally as each video finishes processing, so you can monitor outcomes in near real time and export as needed. ### Key features - ⚡ Robust proxy fallback Starts direct (no proxy), then automatically falls back to Apify datacenter proxy, then residential proxy with up to 3 retries — helping your fb video transcript extractor stay resilient when sites rate-limit or block requests. - 🧩 Structured JSON output Clean, developer-friendly records with url, transcript, error, and timestamp fields — perfect for automation pipelines, analysis, or integrations. - 📚 Batch processing Process multiple Facebook video URLs in a single run. Each item is pushed to the dataset as it completes, enabling streaming-style consumption. - 🔁 Built-in retry logic Each network step uses up to 3 attempts with proxy fallback to maximize successful extractions from public videos. - 🔍 Dynamic doc_id discovery with fallback Scans video page JavaScript for the required GraphQL doc_id; falls back to a known working id if not found, increasing reliability across different video pages. - 🌐 Public video support Designed for public Facebook videos and pages, making it a safe alternative to brittle browser extensions for teams that need to download Facebook captions SRT-like text content (plain transcript) at scale. - 🗂️ Apify dataset exports Export results in JSON or CSV from the Apify platform to feed SEO tools, research notebooks, or BI dashboards. ### How to use Facebook Video Transcript Extractor - step by step 1. Sign in to Apify Create a free Apify account or log in. 2. Open the actor Find “Facebook Video Transcript Extractor” in the Apify Store and open it. 3. Add input data Paste one or more Facebook video URLs into urls (string list). Example: - https://www.facebook.com/100044280796927/videos/2301741263587145 - https://www.facebook.com/100044280796927/videos/4141502542759187 4. Configure proxy (recommended) In proxyConfiguration, enable Apify Proxy to allow automatic fallback to datacenter and residential IPs if direct access is blocked. 5. Start the run Click Start. The actor will fetch each video page, locate the GraphQL doc_id (with fallback), and extract transcript text if available. 6. Monitor progress Watch the run log. Results are pushed to the default dataset as each URL completes, including any error messages for troubleshooting. 7. Download your results Open the run’s dataset and export to JSON or CSV. Use the transcript field to save Facebook video captions, build analytics, or repurpose content. Pro Tip: For maximum throughput and reliability when you download facebook video transcript data at scale, enable Apify Proxy with residential fallback to minimize blocking. ### Use cases | Use case name | Description | | --- | --- | | Marketing + content repurposing | Turn Facebook videos into blog posts, captions, and briefs by converting facebook video to text and centralizing transcripts for editorial teams. | | SEO + keyword research | Extract keyword-rich scripts from public videos to inform on-page optimization and content ideation. | | Media + newsroom workflows | Transcribe interviews or statements quickly for quoting and fact-checking without manual effort. | | Accessibility + compliance | Provide text alternatives for public videos to enhance accessibility and support internal compliance initiatives. | | Academic + social research | Analyze topics, sentiment, and trends using transcript corpora collected from public Facebook videos. | | Data engineering pipelines | Feed structured transcript output (JSON/CSV) into BI dashboards, NLP models, or ETL jobs on Apify for automated enrichment. | ### Why choose Facebook Video Transcript Extractor? This actor is built for precision, scalability, and reliability — a production-ready facebook transcript downloader for teams who need consistent outputs. - 🎯 Accurate, structured extraction from public video pages using Facebook’s GraphQL interface - 🚀 Scales to multiple URLs per run with incremental dataset writes - 🛡️ Resilient networking with direct → datacenter → residential proxy fallback and retries - 👩‍💻 Developer-friendly JSON output and Apify dataset exports for easy integration - 🔒 Public-only data collection aligned with ethical use; no private or authenticated content - 💸 Operates on Apify’s cloud infrastructure — more reliable than ad-hoc browser extensions - 🔗 Flexible for SEO, research, analytics, and automation pipelines In short, it’s a robust fb video transcript extractor that outperforms brittle, manual alternatives. ### Is it legal / ethical to use Facebook Video Transcript Extractor? Yes — when used responsibly. This actor targets publicly available Facebook video pages and extracts transcripts where present. Always ensure your use complies with: - Facebook’s Terms of Service - Applicable privacy and data protection laws (e.g., GDPR, CCPA) - Ethical guidelines: avoid personal/private data and use results for legitimate purposes The actor does not access private profiles or authenticated data. Consult your legal team for edge cases. ### Input parameters & output format Example JSON input ```json { "urls": [ "https://www.facebook.com/100044280796927/videos/2301741263587145", "https://www.facebook.com/100044280796927/videos/4141502542759187" ], "keyword": "", "sort_order": "relevance", "max_comments": 100, "proxyConfiguration": { "useApifyProxy": true } } ```` Parameters - urls - Type: array of strings - Description: Array of Facebook video URLs to extract transcripts from - Required: No - Default: Not set (UI may show example prefill) - keyword - Type: string - Description: Keyword to search for Facebook videos (alternative to URLs) - Required: No - Default: "" - Note: Not implemented yet in v1.0; if provided without urls, the actor will log a warning and stop. - sort\_order - Type: string (enum: relevance, date, views) - Description: Sort order for search results - Required: No - Default: Not set - Note: Present in input schema but not used in v1.0 extraction logic. - max\_comments - Type: integer (1–1000) - Description: Maximum number of comments to extract - Required: No - Default: Not set - Note: Present in input schema but not used in v1.0 extraction logic. - proxyConfiguration - Type: object - Description: Configure proxy settings for the actor - Required: No - Default: Not set (if useApifyProxy is false, the actor starts direct and cannot fall back to Apify proxies) Example output JSON ```json [ { "url": "https://www.facebook.com/mrbeast/videos/546259055092102", "transcript": "This is your money. How much of it do you want? I'm taking my share, 1 hundredthousand. Okay. 10 people said they trusted me. You have the opportunity right now to take a million dollars. Absolutely not. They won't know. Uh", "error": null, "timestamp": 1761496105.9149563 } ] ``` Notes - transcript may be null if no transcript is present in the GraphQL response. - error contains a human-readable message if extraction fails or no transcript is found. - timestamp reflects when the item was processed. ### Related tools | 🧰 Tool | Link | | --- | --- | | 📄 Facebook Page Scraper | https://apify.com/scraper-engine/facebook-page-scraper | | 🎬 Facebook Reels Scraper | https://apify.com/scraper-engine/facebook-reels-scraper | | 📹 Facebook Videos Scraper | https://apify.com/scraper-engine/facebook-videos-scraper | ### FAQ #### How can I download a Facebook video transcript with this actor? Paste one or more public Facebook video URLs into urls, run the actor, and export the dataset. You’ll get a transcript field with cleaned text you can use for analysis or content repurposing. #### Can it get SRT from a Facebook video? Not directly. The actor outputs plain transcript text, not an SRT file. You can convert the transcript to SRT using your own scripts or third‑party tools if you need an SRT format. #### Does it work for private videos? No. The extractor is designed for publicly accessible Facebook videos only. It does not access private or authenticated content. #### Can I extract multiple videos at once? Yes. Provide multiple URLs in the urls array to run batch extraction. Each result is pushed to the dataset as it completes. #### Do I need to enable a proxy? Proxy is optional but recommended. The actor starts direct and can automatically fall back to Apify datacenter and residential proxies (when useApifyProxy is enabled) to improve success rates. #### Does the keyword search work? Not yet. The keyword parameter exists in the input schema but is not implemented in version 1.0. Please supply direct video URLs in urls. #### What happens if a transcript isn’t found? The transcript field will be null and error will include “No transcript found in the response.” You can review the run logs and consider enabling Apify Proxy for improved access. #### Is this a good alternative to a Facebook video transcript Chrome extension? Yes. It runs on Apify’s cloud and processes public video pages via GraphQL, avoiding the instability of browser-based extensions and letting you scale reliably. ### Final thoughts Facebook Video Transcript Extractor is built to turn public Facebook videos into clean, structured text for SEO, research, and accessibility. With batch processing, resilient proxy fallback, and simple JSON output, it’s a dependable facebook transcript downloader for marketers, developers, analysts, and researchers. Integrate the dataset into your pipelines, export JSON/CSV for your tools, and start extracting smarter, scalable insights from Facebook video captions today. # Actor input Schema ## `urls` (type: `array`): Array of Facebook video URLs to extract transcripts from ## `keyword` (type: `string`): Keyword to search for Facebook videos (alternative to URLs) ## `sort_order` (type: `string`): Sort order for search results ## `max_comments` (type: `integer`): Maximum number of comments to extract ## `proxyConfiguration` (type: `object`): Configure proxy settings for the actor ## Actor input object example ```json { "urls": [ "https://www.facebook.com/100044280796927/videos/2301741263587145", "https://www.facebook.com/100044280796927/videos/4141502542759187" ] } ``` # 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 = { "urls": [ "https://www.facebook.com/100044280796927/videos/2301741263587145", "https://www.facebook.com/100044280796927/videos/4141502542759187" ], "keyword": "" }; // Run the Actor and wait for it to finish const run = await client.actor("scrapebase/facebook-video-transcript-extractor").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 = { "urls": [ "https://www.facebook.com/100044280796927/videos/2301741263587145", "https://www.facebook.com/100044280796927/videos/4141502542759187", ], "keyword": "", } # Run the Actor and wait for it to finish run = client.actor("scrapebase/facebook-video-transcript-extractor").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 '{ "urls": [ "https://www.facebook.com/100044280796927/videos/2301741263587145", "https://www.facebook.com/100044280796927/videos/4141502542759187" ], "keyword": "" }' | apify call scrapebase/facebook-video-transcript-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapebase/facebook-video-transcript-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Video Transcript Extractor", "description": "✨ Facebook Video Transcript Extractor to extract transcripts from public videos quickly and at scale. Collect captions, timestamps, and spoken content with ease. Ideal for research, SEO, and content analysis. Features: ⚡ fast extraction • 📊 clean output • 🔍 insights • 🌍 scalable automation", "version": "1.0", "x-build-id": "UqDaRao8RXYu4oBbP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapebase~facebook-video-transcript-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapebase-facebook-video-transcript-extractor", "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/scrapebase~facebook-video-transcript-extractor/runs": { "post": { "operationId": "runs-sync-scrapebase-facebook-video-transcript-extractor", "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/scrapebase~facebook-video-transcript-extractor/run-sync": { "post": { "operationId": "run-sync-scrapebase-facebook-video-transcript-extractor", "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": { "urls": { "title": "Facebook Video URLs", "type": "array", "description": "Array of Facebook video URLs to extract transcripts from", "items": { "type": "string" } }, "keyword": { "title": "Search Keyword", "type": "string", "description": "Keyword to search for Facebook videos (alternative to URLs)" }, "sort_order": { "title": "Sort Order", "enum": [ "relevance", "date", "views" ], "type": "string", "description": "Sort order for search results" }, "max_comments": { "title": "Maximum Comments", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of comments to extract" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Configure proxy settings for the actor" } } }, "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 } } } } } } } } } } ```