Ad Library

GET /v1/ad-library/facebook/ad-transcript

Facebook Ad Transcript API

Extract timestamped transcripts from any public Ad Library video in a single request.

TL;DR

The Facebook Ad Transcript API (Ad Library) returns extract timestamped transcripts from any public Ad Library video in a single request. It's a single authenticated GET request to /v1/ad-library/facebook/ad-transcript that responds with clean JSON, costs 17 credits, and is cached for 24 hours (repeat calls are free). Start with 100 free credits — no credit card.

What is the Facebook Ad Transcript API?

The Facebook Ad Transcript API lets you extract the full, timestamped transcript from Ad Library 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

url*stringMeta Ad Library ad URL or ad ID.

API keyoptionalPaste your key to get a ready-to-run snippet. It stays in your browser.

curl "https://api.captapi.com/v1/ad-library/facebook/ad-transcript?url=https%3A%2F%2Fadstransparency.google.com%2F" \
  -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": 17,
  "data": {
    "transcript": "Hey everyone, welcome back to the channel. Today we're breaking down structured data APIs.",
    "wordCount": 1240,
    "segments": 86,
    "transcriptSegments": [
      {
        "text": "Hey everyone, welcome back to the channel.",
        "start": 0,
        "duration": 4.12,
        "timestamp": "00:00"
      },
      {
        "text": "Today we're breaking down structured data APIs.",
        "start": 4.12,
        "duration": 4.28,
        "timestamp": "00:04"
      }
    ]
  }
}

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	Meta Ad Library ad URL or ad ID.

Authentication: send your key as Authorization: Bearer capt_live_.... A typical call costs 17 credits. Repeat calls for the same request are served from cache for free.

Using an AI agent? This endpoint is the MCP tool facebook_ad_library_ad_transcript via @captapi/mcp. Set it up →

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/ad-library/facebook/ad-transcript and 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 Ad Transcript API do?+

The Facebook Ad Transcript API lets you extract the full, timestamped transcript from a public Ad Library video using one GET request to /v1/ad-library/facebook/ad-transcript. It returns clean JSON — no OAuth or scraping setup required.

How many credits does the Facebook Ad Transcript API cost?+

Each successful call costs 17 credits. Responses are cached for 24 hours, and cached results cost 0 credits. Failed or empty results are never charged.

Do I need a Ad Library 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 Ad Library 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 Ad 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 Ad Library APIs

Facebook Ad Library Search API Facebook Company Ads API Facebook Ad Library Search Companies API Facebook Ad Details API TikTok Ad Library Search API TikTok Ad Details API

Ready to use the Facebook Ad Transcript API?

Get started free