Facebook · Guide

How to get a Facebook transcript

TL;DR
To get a Facebook transcript, sign up for a free Captapi key, then send one GET request to /v1/facebook/transcript with your input. You get clean JSON back in seconds for 2 credits per call — no OAuth, scraping or platform SDKs. Extract timestamped transcripts from any public Facebook video in a single request.

How to get a Facebook transcript (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Facebook Transcript API

    Send an authenticated GET request to /v1/facebook/transcript with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl "https://api.captapi.com/v1/facebook/transcript?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1376651124309650%2F" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "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"
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
urlstring YesPublic 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.
cachebooleanNoSet true to serve from the 24h response cache. Default false — always fetch fresh data.

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 infrastructure setup required.

How many credits does the Facebook Transcript API cost?

Each successful call costs 2 credits. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. 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, Rumble, Spotify, Kwai, and more. 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 and automatic retries. Pass cache=true to serve from the 24h shared cache (0 credits on hit); default is always fresh. Use it for analytics, monitoring, and content automation.

Ready to get a Facebook transcript?

Start free with 100 credits — no credit card required.

Get your free API key