# Facebook Adlibrary Ad Transcript API (https://www.socialcrawl.dev/platforms/facebook/adlibrary-ad-transcript)

> Retrieves a transcript for a single Facebook Ad Library video ad. Uses Facebook-provided captions when available, otherwise transcribes the public video URL on demand. Ads without retrievable captions return a 404 RESOURCE_NOT_FOUND, and on-demand transcription can fail transiently (503) — both outcomes are free; credits are only deducted when a transcript is returned.

TL;DR: `GET /v1/facebook/adlibrary/ad/transcript` costs 10 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Facebook Ad Library ad ID. |
| `url` | no | Facebook Ad Library ad URL. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/facebook/adlibrary/ad/transcript" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get the transcript of a Facebook video ad?

Send a GET request to /v1/facebook/adlibrary/ad/transcript with either the ad id or the ad url (one of the two). SocialCrawl transcribes the ad's spoken audio and returns the transcript as text, ready for search and analysis.

### Do I pass the ad id or the ad url?

Pass exactly one of them. Use id if you already have the Ad Library identifier, or url if you have the ad's Facebook Ad Library link. Both anchor to the same video ad, so pick whichever you already hold.

### How much does the ad transcript endpoint cost?

It is a premium endpoint at 10 credits per call, because speech-to-text transcription is compute-heavy. If the transcript comes back empty or the transcription fails, the credits are refunded automatically, so you only pay for a real result.

### Why turn video ads into text?

A text transcript makes competitor video creative searchable and analyzable. You can grep hooks, offers, and calls to action across an advertiser's ad set, feed the copy into an LLM, or track messaging shifts over time for ad creative intelligence.

### Is the response synchronous?

Yes. This is a direct, synchronous endpoint: one GET request returns one JSON payload with the transcript, no polling or callbacks. Pair it with /v1/facebook/adlibrary/ad to combine the transcript with the ad's creative and spend metadata.

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get the transcript of a Facebook Ad Library video ad via API?
- How can I turn competitor Facebook video ads into searchable text for creative analysis?
- Does SocialCrawl refund credits if a Facebook ad transcript comes back empty?