Facebook Ad Transcript API

What is the Facebook Ad Transcript API?

Paste a Meta Ad Library ad URL or ad ID. For video ads the video is transcribed: transcriptSource "audio", language (ISO-639-1), durationSec, transcript (full spoken text) and segments[{start, end, text}] in seconds. The written copy stays in headline / text / cta / landingUrl — text is the ad's body copy, not speech. When the video has no speech the written copy is returned with transcriptSource "copy" (transcript null, segments []). Image and carousel ads without a video return 422 NO_VIDEO at 0 credits. Transcripts are stored per ad id, so repeat calls for the same ad are 0 credits. 2 credits per new transcript or copy answer.

What you get

• Spoken transcript + timed segments for video ads
• language (ISO-639-1) and durationSec
• Written copy fallback (transcriptSource "copy") when there is no speech
• NO_VIDEO (0 credits) for image/carousel ads
• Repeat calls for the same ad id are free

Fill in the parameters below and copy a ready-to-run request, or open the live Playground to run it against your account (no API key paste).

curl "https://api.captapi.com/v1/ad-library/facebook/ad-transcript?url=https%3A%2F%2Fwww.facebook.com%2Fads%2Flibrary%2F%3Fid%3D317161109571794" \
  -H "Authorization: Bearer capt_live_..."
# or: -H "x-api-key: capt_live_..."

Example response

{
  "success": true,
  "data": {
    "platform": "facebook_ad_library",
    "url": "https://www.facebook.com/ads/library/?id=317161109571794",
    "adId": "317161109571794",
    "transcript": "headline: Voting Information Center\nbody: The Voting Information Center—one-tap voting registration information from election experts and authorities in one place.\ncta: Learn more\nlandingUrl: http://facebook.com/votinginformationcenter",
    "transcriptSegments": [
      {
        "speaker": "headline",
        "text": "Voting Information Center",
        "start": 0,
        "duration": 0,
        "timestamp": "00:00"
      },
      {
        "speaker": "body",
        "text": "The Voting Information Center—one-tap voting registration information from election experts and authorities in one place.",
        "start": 0,
        "duration": 0,
        "timestamp": "00:00"
      },
      {
        "speaker": "cta",
        "text": "Learn more",
        "start": 0,
        "duration": 0,
        "timestamp": "00:00"
      },
      {
        "speaker": "landingUrl",
        "text": "http://facebook.com/votinginformationcenter",
        "start": 0,
        "duration": 0,
        "timestamp": "00:00"
      }
    ],
    "wordCount": 25,
    "segments": 4,
    "advertiser": {
      "id": "108824017345866",
      "name": "Meta",
      "url": "https://www.facebook.com/Meta/",
      "logo": "https://scontent-dfw5-2.xx.fbcdn.net/v/t1.6435-9/119568341_200337161527884_7846459746434232698_n.png?stp=dst-png_s60x60&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ZqrAiU5uA1sQ7kNvwHsXpf9&_nc_oc=AdqVVq_tCCm9QfdHEQa5d82UKJTt9DT4LxrW9m95vTx7VJLcyuQH74gIZv0WeiJgIfo&_nc_zt=23&_nc_ht=scontent-dfw5-2.xx&_nc_gid=oKi5rqU7-78Y6XFLpAVqvA&_nc_ss=79289&oh=00_AQDIgONmGu5lj1i0jpr_nH9fjb7afatDtlB-wsXtBQNtZQ&oe=6A8F324E"
    }
  }
}

Billing metadata is returned in response headers: X-Captapi-Credits (credits charged), X-Captapi-Cache (hit or miss), and X-Captapi-Request-Id (include it when contacting support). Where the response has a source field, it names the path that served the data: native, extended, cache or asr. 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 and a data object with the following fields:

Parameters

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 2 credits. Pass cache=true for a free 24h cache hit; default is always fresh.

How it works

1. 1. Sign up — get 100 free credits, no card required.
2. 2. Create a key from your dashboard.
3. 3. Send one request to /v1/ad-library/facebook/ad-transcript and parse the JSON response.

Use cases

Frequently asked questions

More Facebook Ad Library APIs