# Facebook Transcript Scraper API – Fast & Reliable (`apple_yang/facebook-transcript-scraper-api`) Actor \[1/1000 results]Facebook Transcript Scraper API for extracting clean, structured transcripts from public videos. Fast, reliable, and built for AI and automation. - **URL**: https://apify.com/apple\_yang/facebook-transcript-scraper-api.md - **Developed by:** [APISmith](https://apify.com/apple_yang) (community) - **Categories:** AI, Social media, Videos - **Stats:** 22 total users, 6 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.60 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## 🎙️ Facebook Transcripts Scraper API Turn Facebook videos into **clean, structured transcripts** — fast, reliable, and ready for automation. This API extracts **auto-generated speech-to-text transcripts** from public Facebook videos, designed for developers, data teams, and AI agents that need **spoken content in text form**. --- ### 📌 Overview The **Facebook Transcripts Scraper API** allows you to submit a Facebook video URL and receive: - 📝 **Full auto-generated transcript text** - ⏱️ **Timestamped transcript segments** - 🎥 Direct video & audio URLs - 📊 Engagement and creator metadata Built with a **transcript-first mindset**, this API is ideal for AI pipelines, content analysis, and large-scale audio-to-text workflows. > ⚠️ Only **public Facebook videos** are supported. --- ### 🎁 What You Can Get From This API For each Facebook video URL, the API returns: - ✅ **Complete transcript text (auto speech-to-text)** - ✅ **Segmented transcript with timestamps** - ✅ Video title & duration - ✅ Video and audio playback URLs - ✅ Engagement metrics (plays, reactions, comments) - ✅ Creator profile info - ✅ Per-request error handling (safe for batch jobs) All outputs are delivered in **structured JSON**, optimized for machines and automation. --- ### 🧩 Typical Use Cases 💡 Perfect for workflows that care about **what is being said**: - 🤖 **AI agents ingesting spoken content** - 🧠 **LLM-based summarization & semantic analysis** - 🎧 **Audio-to-text pipelines** - 🔍 **Content understanding & moderation** - 📊 **Social media research & insight extraction** - 🔁 **Batch transcription of Facebook videos** If your system needs **text, not media**, this API fits naturally. --- ### 💰 Cost of Usage Simple, transparent, and designed for scale. - 💵 **$1.00 / 1,000 results** - 🎙️ **Cost-effective audio-to-text (auto transcription)** - 📦 Pay only for what you successfully process Ideal for both **experimentation** and **production-level AI workloads**. --- ### 📥 Input Parameters #### (1) Input Format | Field | Type | Required | Description | |---------|--------|----------|-------------| | videoUrl | string | Yes | Public Facebook video URL | --- #### (2) Input Example ```json { "videoUrl": "https://www.facebook.com/61567530334836/videos/1115932820735409/" } ```` *** ### 📤 Output Parameters #### (1) Output Format Description | Field | Type | Description | |----------------|---------|-------------| | url | string | Facebook video URL | | title | string | Video title | | videoUrl | string | Direct video playback URL | | audioUrl | string | Direct audio playback URL | | duration | number | Video duration (seconds) | | playCount | number | Number of plays | | commentCount | number | Number of comments | | reactionCount | number | Number of reactions | | nickname | string | Creator nickname | | avatarUri | string | Creator avatar image URL | | createTime | number | Video creation timestamp | | text | string | Full transcript text | | segments | array | Transcript segments with timestamps | | errMsg | string | Error message (empty if success) | | timestamp | string | API response timestamp (ISO format) | *** #### (2) Output Example ```json { "url": "https://www.facebook.com/61567530334836/videos/1115932820735409/", "title": "Q & A about sleeping", "videoUrl": "https://video-iad3-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQPwJW0ejq26Pqvi6FTGlTSXRjUZ7BTizCUKv63qXQgQm_B2VksLeLpTEkR6pK9VITfft0VEZBHZXEVEDnxiLWVQn4vQveAqs8HWRhc.mp4?_nc_cat=102&_nc_sid=9ca052&_nc_ht=video-iad3-1.xx.fbcdn.net&_nc_ohc=8cmWCdoyWKYQ7kNvwFnjIXW&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfcjJhdjEtcjFnZW4ydnA5X3E5MCIsInZpZGVvX2lkIjoxMTE1OTMyODIwNzM1NDA5LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjoxNDUzMzU1NjE5MDk5ODk3LCJhc3NldF9hZ2VfZGF5cyI6ODcsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjo0MywiYml0cmF0ZSI6MTQ2MDAzNywidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=mCjbr5eyHB-Q_vFe6ggd4Q&_nc_zt=28&oh=00_AfrsDpyNr26WmNXf7E6zRNBlg9LCWFOiHIcRiCoPBF4cuQ&oe=69667C7F", "audioUrl": "https://video-iad3-2.xx.fbcdn.net/o1/v/t2/f2/m412/AQNIK1AuA7LxF3J5B3NWf848il4Q4ZGc2Xt_GN509xLss11av0TpkHI7eb-SR5ZfvhlktcVxCV7O-tropYgohVqYb7yoT6emOLTYsYw.mp4?_nc_cat=103&_nc_sid=9ca052&_nc_ht=video-iad3-2.xx.fbcdn.net&_nc_ohc=YoZ_H7O6IJwQ7kNvwHGZs4o&efg=eyJ2ZW5jb2RlX3RhZyI6ImRhc2hfbG5faGVhYWNfdmJyM19hdWRpbyIsInZpZGVvX2lkIjoxMTE1OTMyODIwNzM1NDA5LCJvaWxfdXJsZ2VuX2FwcF9pZCI6MCwiY2xpZW50X25hbWUiOiJ1bmtub3duIiwieHB2X2Fzc2V0X2lkIjoxNDUzMzU1NjE5MDk5ODk3LCJhc3NldF9hZ2VfZGF5cyI6ODcsInZpX3VzZWNhc2VfaWQiOjEwMTIyLCJkdXJhdGlvbl9zIjo0MywiYml0cmF0ZSI6NjU0NTAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=mCjbr5eyHB-Q_vFe6ggd4Q&_nc_zt=28&oh=00_AfqA9C4saMy53vd4W4SBYL7m5ypIgdB6HioO_KAsq6Grjg&oe=69667428", "createTime": 1760410628, "playCount": 1374261, "commentCount": 502, "reactionCount": 75332, "nickname": "Dr. Shu", "avatarUri": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/470138163_122118830888584344_7360706064429064787_n.jpg?stp=cp6_dst-jpg_s40x40_tt6&_nc_cat=108&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=alHuP3EhAuwQ7kNvwFl8FUP&_nc_oc=AdlBo7k-cZ_CWCfY28MbnpIURuyFTL8oKeRec1Zi58x_-FklZX-JtRv9ezhIt4Xoizk&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=mCjbr5eyHB-Q_vFe6ggd4Q&oh=00_Afqb87BlcUVxN3seMIz_3of4T7qTZDKwRWjI6yRiXjelqg&oe=69666F25", "duration": 43.5, "text": "Hello, Dr. What's your name? Your name is Yehdae. My name is Yehdae, so I've got a chance for you to listen to which is murdered in the country because of your income. And you get started with me. My name is Yehdae, and I'm here to do the work in you. My name is Yehdae, because of my life and I'm not yet here. So this is my name. I know you're good. We're good. No, she's good. So how are you, how are you going to start with your first question? You're going to ask me to ask what you are going to say? Why are you going to ask me to ask you to answer your question? I'm going to tell you a few questions, but I can't ask you to answer your question.", "segments": [ { "start": 0, "end": 0.68, "text": " Hello, Dr." }, { "start": 2.28, "end": 2.98, "text": " What's your name?" }, { "start": 3.3, "end": 4.22, "text": " Your name is Yehdae." }, ... ], "errMsg": "", "timestamp": "2026-01-09T07:32:28.253Z" } ``` *** ### ⭐ Why This API Is Different 🚀 **Built specifically for transcript extraction** - 🧠 **AI-first design**\ Clean transcripts with timestamps, optimized for LLMs and AI agents. - 🎯 **Raw transcripts, no opinions**\ No summaries, no rewrites — just reliable speech-to-text output. - 📦 **Automation-safe & batch-ready**\ Predictable schema, stable fields, per-URL error handling. - 💸 **Highly cost-efficient**\ Pay-per-result pricing designed for real-world usage at scale. *** ### 📝 Notes - Only **public Facebook videos** are supported - Transcript accuracy depends on audio quality and speaker clarity - Returned transcripts are auto-generated (speech-to-text) - Please ensure compliance with Facebook’s terms and local regulations - Free users can only try video transcription with a duration of no more than **5 minutes**, while paid users are not limited by the duration. *** ### 🆘 Support Need help or have questions? 📧 **Email:** support@apismith.online # Actor input Schema ## `videoUrl` (type: `string`): The URL of the facebook you want to get the data from. ## Actor input object example ```json { "videoUrl": "https://www.facebook.com/61567530334836/videos/1115932820735409/" } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "videoUrl": "https://www.facebook.com/61567530334836/videos/1115932820735409/" }; // Run the Actor and wait for it to finish const run = await client.actor("apple_yang/facebook-transcript-scraper-api").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 = { "videoUrl": "https://www.facebook.com/61567530334836/videos/1115932820735409/" } # Run the Actor and wait for it to finish run = client.actor("apple_yang/facebook-transcript-scraper-api").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 '{ "videoUrl": "https://www.facebook.com/61567530334836/videos/1115932820735409/" }' | apify call apple_yang/facebook-transcript-scraper-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=apple_yang/facebook-transcript-scraper-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Transcript Scraper API – Fast & Reliable", "description": "[1/1000 results]Facebook Transcript Scraper API for extracting clean, structured transcripts from public videos. Fast, reliable, and built for AI and automation.", "version": "0.0", "x-build-id": "2X7wHXOcubAtPwtui" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apple_yang~facebook-transcript-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apple_yang-facebook-transcript-scraper-api", "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/apple_yang~facebook-transcript-scraper-api/runs": { "post": { "operationId": "runs-sync-apple_yang-facebook-transcript-scraper-api", "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/apple_yang~facebook-transcript-scraper-api/run-sync": { "post": { "operationId": "run-sync-apple_yang-facebook-transcript-scraper-api", "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": [ "videoUrl" ], "properties": { "videoUrl": { "title": "The URL of the facebook", "type": "string", "description": "The URL of the facebook you want to get the data from." } } }, "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 } } } } } } } } } } ```