Facebook Ad Library Ad Transcript API
Ad Transcript
for Facebook Ad Library, in one call.
The Ad Transcript endpoint from ScrapeCreators gives developers reliable access to Facebook Ad Library data without the hassle of building and maintaining scrapers. Our endpoint makes it easy to retrieve ad transcript data in real-time for your applications. Get native captions or an AI transcript for a Facebook Ad Library video ad by ID or URL. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.
// Example: Ad Transcript from the Facebook Ad Library API
const response = await fetch(`https://api.scrapecreators.com/v1/facebook/adLibrary/ad/transcript`, {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(data);Endpoint spec
What the Ad Transcript endpoint returns
/v1/facebook/adLibrary/ad/transcript Parameters
allow_long_transcription boolean Paid opt-in, enabled only by the literal query value 'true' (allow_long_transcription=true). Defaults to false when omitted; other values do not enable paid mode. By default, successful AI transcription of videos up to 120 seconds (two minutes, inclusive) costs a flat 1 credit per request. Over 120 seconds, videos cannot be AI-transcribed by default. Set allow_long_transcription=true to opt into paid AI with no fixed duration cap: ALL successful AI transcriptions in this mode cost 10 credits per started minute, including short videos: 10 * ceil(duration_seconds / 60). For example, 177 seconds costs 30 credits and an opted-in 60 seconds costs 10 credits. Empty AI results and errors cost 0 credits for AI transcription. This flag does not force AI and does not enable transcription or AI fallback by itself. Keep get_transcript=true or use_ai_as_fallback=true where required by the endpoint. Returned native captions still cost 1 credit on dedicated transcript routes, even for long videos with this flag; on detail routes they leave the base price unchanged. These routes remain synchronous. Allow at least 30 seconds on your client. Paid long transcription can exceed resource limits or timeouts, so successful transcription of long videos is not guaranteed.
id string Facebook Ad Id
url string Facebook Ad URL
cache_max_age select If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (Returned native captions cost 1 credit, even for long videos with the paid flag. By default, successful AI up to 120 seconds costs a flat 1 credit per request; over 120 seconds requires allow_long_transcription=true, which bills ALL successful AI at 10 credits per started minute, including short videos; empty AI results and errors cost 0 credits; no transcript: 0 credits). [See the Caching page for details.](https://docs.scrapecreators.com/caching)
Quick start
Ad Transcript quick start
Sign up, grab your API key, paste this in. First response in under a minute.
// Example: Ad Transcript from the Facebook Ad Library API
const response = await fetch(`https://api.scrapecreators.com/v1/facebook/adLibrary/ad/transcript`, {
headers: {
'x-api-key': 'YOUR_API_KEY'
}
});
const data = await response.json();
console.log(data);Why us
Why use this Ad Transcript endpoint
Real-time data access
Get the most up-to-date Ad Transcript data without dealing with rate limits or IP blocks.
Simple integration
Clear documentation and a straightforward REST endpoint make it easy to get started in any language.
High reliability
Our infrastructure ensures high uptime and consistent performance for your applications, even at scale.
Comprehensive data
Access comprehensive Ad Transcript data through our carefully designed endpoint.
Use cases
Ad Transcript endpoint use cases
Data analysis
Analyze Ad Transcript data to gain insights and make data-driven decisions.
Content monitoring
Monitor Ad Transcript content to track changes and updates in real-time.
Integration
Integrate Ad Transcript data into your applications and services.
Automation
Automate processes using Ad Transcript data to improve efficiency.
Reporting
Generate reports and analytics using Ad Transcript data.
Custom solutions
Build custom solutions leveraging Ad Transcript data for your specific needs.
More Facebook Ad Library endpoints
Keep exploring the Facebook Ad Library API
Use this endpoint with related Facebook Ad Library endpoints when you need profiles, posts, search, comments, and engagement data in one workflow.
Search
GET /v1/facebook/adLibrary/search/ads Search the Facebook (Meta) Ad Library by keyword. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.
Search
POST /v1/facebook/adLibrary/search/ads Search the Facebook (Meta) Ad Library by keyword. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.
Company Ads
GET /v1/facebook/adLibrary/company/ads Get all the ads a company has running. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.
Company Ads
POST /v1/facebook/adLibrary/company/ads Get all the ads a company has running. Use GET for normal requests. If the cursor becomes too large after extensive pagination, use POST and send the same parameters in the JSON body.
Search for Companies
GET /v1/facebook/adLibrary/search/companies Search for companies by name and get their ad library page id
Ad Details
GET /v1/facebook/adLibrary/ad Pass the Ad ID and get back details about the ad. Be careful that if an ad has multiple versions, you're actually going to want to get the title from the 'cards' object.
FAQ
Questions we hear
about this endpoint.
Is the Ad Transcript endpoint official?
No, ScrapeCreators provides an unofficial Ad Transcript endpoint that lets you access Facebook Ad Library data through our platform. We handle the complexities of data collection so you can focus on building your application.
How current is the Ad Transcript data?
We provide real-time Ad Transcript data from Facebook Ad Library. When you make a request, we fetch the latest information available, so you always get fresh data.
Can I use the Ad Transcript endpoint in production?
Absolutely. Many businesses rely on ScrapeCreators endpoints for their production applications. Our infrastructure is designed for reliability and performance at scale.
Do I need a credit card to try the Ad Transcript endpoint?
No credit card required. Sign up for free and you get 100 credits on the house to test the Ad Transcript endpoint before deciding on a plan. Credits never expire.
What format does the Ad Transcript endpoint return?
The Ad Transcript endpoint returns a clean JSON response over HTTPS. Call `GET https://api.scrapecreators.com/v1/facebook/adLibrary/ad/transcript` with your API key and parse the response like any other REST API.
Get started
Start using Ad Transcript
100 credits on the house. No credit card. Start pulling ad transcript data in under sixty seconds.
Also searched