Facebook Transcript API
Extract timestamped transcripts from any public Facebook video in a single request.
GET request to /v1/facebook/transcript that responds with clean JSON, costs 2 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.What is the Facebook Transcript API?
The Facebook Transcript API lets you extract the full, timestamped transcript from Facebook with a single REST call. No OAuth, no scraping infrastructure, and no platform SDKs — send the URL, get clean structured JSON back. Results are cached for 24 hours, so repeat lookups are instant and free.
What you get
- Full transcript text with start/end timestamps
- Auto-detected language and segment count
- AI audio transcription fallback when no captions exist
- Clean JSON ready for RAG, search, or subtitles
Try it
Fill in the parameters below and copy a ready-to-run request in your language of choice.
Parameters
curl "https://api.captapi.com/v1/facebook/transcript?url=https%3A%2F%2Fwww.facebook.com%2Fwatch%2F%3Fv%3D1234567890123456" \
-H "Authorization: Bearer capt_live_..."Edit the parameters and the code updates instantly. Switch languages and hit copy.
Example response
{
"success": true,
"cached": false,
"creditsUsed": 2,
"data": {
"platform": "facebook",
"url": "https://www.facebook.com/reel/1376651124309650/",
"transcript": "An early morning hangout with the moon and planets, a comet swings by, prime time for the Milky Way, and Saturn's rings shine at a new angle. That's what's up for July. Before sunrise on July 11th and 12th, look toward the eastern sky for a lineup of the moon and planets. On these mornings, the waning crescent moon helps point the way to Mars, with Saturn shining nearby in the morning sky. Uranus is in the same general part of the sky too, but it is much fainter, so you will need binoculars or a telescope to see it. Mars will look like a small reddish point of light, Saturn is brighter and easier to spot, and the moon makes the whole scene easy to locate. Around the new moon on July 14th, Comet 10P-Temple 2 swings by. This is a short-period comet, meaning it returns to the inner solar system on a regular orbit. In this case, it comes back about every five and a half years. It's not a dramatic comet that you see just by looking up at the sky, though. Through binoculars or a telescope, find the constellation Capricornis and look for a small fuzzy glow nearby, possibly with a brighter central knot and a short, broad, fan-shaped tail. For the best chance to view the comet, head somewhere dark away from city lights. Start looking once the sky is fully dark, ideally about 45 to 60 minutes after sunset. Those same dark nights around the July 14th new moon are also the best time this month to look for the Milky Way. From a dark location away from city lights, the Milky Way appears as a pale, cloudy band across the summer sky. The bright, cloudy region of the Milky Way marks the direction of the galactic center. It looks so dense because we're looking toward one of the most crowded parts of our galaxy, where countless stars glow behind dark clouds of cosmic dust. Late in the evening, look low in the southern sky for a group of stars shaped like a big hook or scorpion tail. That's Scorpius. The bright, cloudy part of the Milky Way is nearby, close to another group of stars called Sagittarius. For the best chance to see the Milky Way, go somewhere dark, give your eyes time to adjust, and try not to look at your phone. Later in July, Saturn is a rewarding target for telescope users. Saturn's rings are still tilted at a very shallow angle from our point of view, making them look unusually thin. The rings aren't disappearing, but how they appear from Earth is changing. It's a great reminder that our view of the solar system is always in motion. Here are the phases of the Moon for July. You can stay up to date on all of NASA's missions exploring the solar system and beyond at science.nasa.gov. I'm Raquel Villanueva from NASA's Jet Propulsion Laboratory, and that's what's up this month.",
"transcriptSegments": [
{
"text": "An early morning hangout with the moon and planets, a comet swings by, prime time for",
"start": 0,
"duration": 5.26,
"end": 5.26,
"timestamp": "00:00"
},
{
"text": "the Milky Way, and Saturn's rings shine at a new angle.",
"start": 5.26,
"duration": 4.14,
"end": 9.4,
"timestamp": "00:05"
},
{
"text": "That's what's up for July.",
"start": 10.1,
"duration": 1.44,
"end": 11.54,
"timestamp": "00:10"
},
{
"text": "Before sunrise on July 11th and 12th, look toward the eastern sky for a lineup of the",
"start": 12.28,
"duration": 5.32,
"end": 17.6,
"timestamp": "00:12"
},
{
"text": "moon and planets.",
"start": 17.78,
"duration": 1.04,
"end": 18.82,
"timestamp": "00:17"
},
{
"text": "On these mornings, the waning crescent moon helps point the way to Mars,",
"start": 19.42,
"duration": 4.84,
"end": 24.26,
"timestamp": "00:19"
},
{
"text": "with Saturn shining nearby in the morning sky.",
"start": 24.26,
"duration": 3.34,
"end": 27.6,
"timestamp": "00:24"
},
{
"text": "Uranus is in the same general part of the sky too, but it is much fainter,",
"start": 27.6,
"duration": 5.1,
"end": 32.7,
"timestamp": "00:27"
},
{
"text": "so you will need binoculars or a telescope to see it.",
"start": 32.72,
"duration": 3.28,
"end": 36,
"timestamp": "00:32"
},
{
"text": "Mars will look like a small reddish point of light,",
"start": 36.66,
"duration": 2.46,
"end": 39.12,
"timestamp": "00:36"
},
{
"text": "Saturn is brighter and easier to spot,",
"start": 39.48,
"duration": 2.64,
"end": 42.12,
"timestamp": "00:39"
},
{
"text": "and the moon makes the whole scene easy to locate.",
"start": 42.76,
"duration": 3.02,
"end": 45.78,
"timestamp": "00:42"
},
{
"text": "Around the new moon on July 14th, Comet 10P-Temple 2 swings by.",
"start": 47.04,
"duration": 5.52,
"end": 52.56,
"timestamp": "00:47"
},
{
"text": "This is a short-period comet, meaning it returns to the inner solar system on a regular orbit.",
"start": 53.04,
"duration": 6.24,
"end": 59.28,
"timestamp": "00:53"
},
{
"text": "In this case, it comes back about every five and a half years.",
"start": 59.48,
"duration": 3.86,
"end": 63.34,
"timestamp": "00:59"
},
{
"text": "It's not a dramatic comet that you see just by looking up at the sky, though.",
"start": 63.96,
"duration": 4.26,
"end": 68.22,
"timestamp": "01:03"
},
{
"text": "Through binoculars or a telescope, find the constellation Capricornis and look for a small fuzzy glow nearby,",
"start": 68.98,
"duration": 8.04,
"end": 77.02,
"timestamp": "01:08"
},
{
"text": "possibly with a brighter central knot and a short, broad, fan-shaped tail.",
"start": 77.02,
"duration": 4.96,
"end": 81.98,
"timestamp": "01:17"
},
{
"text": "For the best chance to view the comet, head somewhere dark away from city lights.",
"start": 82.58,
"duration": 5,
"end": 87.58,
"timestamp": "01:22"
},
{
"text": "Start looking once the sky is fully dark, ideally about 45 to 60 minutes after sunset.",
"start": 87.58,
"duration": 6.04,
"end": 93.62,
"timestamp": "01:27"
},
{
"text": "Those same dark nights around the July 14th new moon are also the best time this month to look for the Milky Way.",
"start": 94.92,
"duration": 7.84,
"end": 102.76,
"timestamp": "01:34"
},
{
"text": "From a dark location away from city lights, the Milky Way appears as a pale, cloudy band across the summer sky.",
"start": 103.22,
"duration": 8.04,
"end": 111.26,
"timestamp": "01:43"
},
{
"text": "The bright, cloudy region of the Milky Way marks the direction of the galactic center.",
"start": 111.68,
"duration": 5.12,
"end": 116.8,
"timestamp": "01:51"
},
{
"text": "It looks so dense because we're looking toward one of the most crowded parts of our galaxy,",
"start": 117.38,
"duration": 5.62,
"end": 123,
"timestamp": "01:57"
},
{
"text": "where countless stars glow behind dark clouds of cosmic dust.",
"start": 123.04,
"duration": 4.28,
"end": 127.32,
"timestamp": "02:03"
},
{
"text": "Late in the evening, look low in the southern sky for a group of stars shaped like a big",
"start": 127.7,
"duration": 5.54,
"end": 133.24,
"timestamp": "02:07"
},
{
"text": "hook or scorpion tail.",
"start": 133.32,
"duration": 2.24,
"end": 135.56,
"timestamp": "02:13"
},
{
"text": "That's Scorpius.",
"start": 135.56,
"duration": 1.28,
"end": 136.84,
"timestamp": "02:15"
},
{
"text": "The bright, cloudy part of the Milky Way is nearby, close to another group of stars called",
"start": 136.98,
"duration": 5.62,
"end": 142.6,
"timestamp": "02:16"
},
{
"text": "Sagittarius.",
"start": 143.16,
"duration": 0.72,
"end": 143.88,
"timestamp": "02:23"
},
{
"text": "For the best chance to see the Milky Way, go somewhere dark,",
"start": 144.4,
"duration": 4.12,
"end": 148.52,
"timestamp": "02:24"
},
{
"text": "give your eyes time to adjust, and try not to look at your phone.",
"start": 148.52,
"duration": 4.02,
"end": 152.54,
"timestamp": "02:28"
},
{
"text": "Later in July, Saturn is a rewarding target for telescope users.",
"start": 154.36,
"duration": 4.1,
"end": 158.46,
"timestamp": "02:34"
},
{
"text": "Saturn's rings are still tilted at a very shallow angle from our point of view,",
"start": 158.92,
"duration": 4.66,
"end": 163.58,
"timestamp": "02:38"
},
{
"text": "making them look unusually thin.",
"start": 163.76,
"duration": 2.04,
"end": 165.8,
"timestamp": "02:43"
},
{
"text": "The rings aren't disappearing, but how they appear from Earth is changing.",
"start": 166.26,
"duration": 5.56,
"end": 171.82,
"timestamp": "02:46"
},
{
"text": "It's a great reminder that our view of the solar system is always in motion.",
"start": 171.96,
"duration": 5.04,
"end": 177,
"timestamp": "02:51"
},
{
"text": "Here are the phases of the Moon for July.",
"start": 178.58,
"duration": 2.5,
"end": 181.08,
"timestamp": "02:58"
},
{
"text": "You can stay up to date on all of NASA's missions exploring the solar system and beyond at science.nasa.gov.",
"start": 182.38,
"duration": 7.46,
"end": 189.84,
"timestamp": "03:02"
},
{
"text": "I'm Raquel Villanueva from NASA's Jet Propulsion Laboratory, and that's what's up this month.",
"start": 189.84,
"duration": 5.64,
"end": 195.48,
"timestamp": "03:09"
}
],
"wordCount": 500,
"segments": 40,
"language": "en"
}
}Failed requests (4xx/5xx) are never charged. See the full list of error codes in the error reference.
Response structure
A successful call returns success, cached, creditsUsed, and a data object with the following fields:
Full transcript
transcriptComplete text transcript of the video.wordCountTotal number of words in the transcript.segmentsTotal number of transcript segments.
Timestamped segments
Each item in transcriptSegments contains:
textThe spoken text for this segment.startStart time in seconds.durationDuration of the segment in seconds.timestampHuman-readable timestamp (MM:SS format).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Public Facebook video or post URL. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble. |
| cache | boolean | No | Responses are cached for 24 hours by default. Set false to bypass the cache and always fetch fresh data (default true). |
Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Repeat calls for the same request are served from cache for free.
How it works
- 1. Sign up — get 100 free credits, no card required.
- 2. Create a key from your dashboard.
- 3. Send one request to
/v1/facebook/transcriptand parse the JSON response.
Use cases
Accessibility
Provide captions and transcripts for hearing-impaired users.
Content Analysis
Analyze spoken content for keywords, topics, and sentiment.
Search & Discovery
Make video content searchable by text.
Content Creation
Extract quotes and key phrases from videos.
Language Learning
Provide text alongside audio for language learners.
Research
Analyze large volumes of video content efficiently.
SEO
Extract text content for search engine optimization.
Frequently asked questions
What does the Facebook Transcript API do?+
The Facebook Transcript API lets you extract the full, timestamped transcript from a public Facebook video using one GET request to /v1/facebook/transcript. It returns clean JSON — no OAuth or scraping setup required.
How many credits does the Facebook Transcript API cost?+
Each successful call costs 2 credits. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.
Do I need a Facebook API key or OAuth?+
No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, and Rumble. We handle proxies, rate limits, retries, and authentication for you.
What if the Facebook video has no captions?+
When no captions are available, Captapi transcribes the audio with AI (Whisper) automatically, so you still get a usable transcript.
Is the Facebook Transcript API suitable for production use?+
Yes. It is a stable REST endpoint with predictable JSON, automatic retries, and a shared 24-hour cache. Use it for RAG pipelines, analytics, monitoring, and content automation.
More Facebook APIs
Ready to use the Facebook Transcript API?
Sign up, grab your key, and make your first call in 60 seconds.