scrapeatlas. Get started
Meta Ads Library API

Meta Ads Library Scraper API for Ads and Advertisers

Search the Meta Ad Library, read ad creatives and explore advertisers. Retrieve video transcripts for a closer look at the message.

Try a request API reference

WHAT YOU CAN BUILD / 08 ENDPOINTS

Put Meta Ads Library data to work.

Find your use case, then explore the request and response.

Search ads

GET/v1/facebook/adLibrary/search/ads

Build an ad inspiration library by searching Meta ads with query filters and paging through matching creatives.

Search ads with a POST body

POST/v1/facebook/adLibrary/search/ads

Build an ad research form that sends its search filters as a JSON body and retrieves matching Meta ads.

Ad details

GET/v1/facebook/adLibrary/ad

Build a creative research card with ad variants, payer, beneficiary and regional transparency details.

Find advertisers

GET/v1/facebook/adLibrary/search/companies

Build an advertiser picker from company-name suggestions and page identifiers for subsequent ad searches.

Get company ads

GET/v1/facebook/adLibrary/company/ads

Build an advertiser research feed by retrieving ads for a selected company name or page ID.

Get company ads with a POST body

POST/v1/facebook/adLibrary/company/ads

Build an advertiser research integration that sends company or page selection in a JSON request body.

Walk compact company ads

POST/v1/facebook/ad-library/companies/ads

Build a compact advertiser archive in your own app by paging through normalized ad records and saving the results.

Ad video transcript

GET/v1/facebook/adLibrary/ad/transcript

Build a searchable ad-script library from speech transcribed from an ad’s primary or carousel video.

HOW IT WORKS

From API key to Meta Ads Library data in four steps.

Run a sample below without a key.

  1. 01

    Get your API key

    Create a free account and copy your key. You start with 100 free credits; no card needed.

  2. 02

    Choose an endpoint

    Pick one of the 8 Meta Ads Library endpoints and add its input, such as a search query.

  3. 03

    Send one request

    Call it with your key in the x-api-key header. ScrapeAtlas reads the public Meta Ads Library data and retries when a read fails.

  4. 04

    Use the JSON

    Get structured JSON with a coverage status. Only successful requests use a credit.

TRY IT HERE / LIVE SAMPLE

Try a sample request.

Try the Meta Ads Library API right here. This sample uses the Search ads endpoint and returns live JSON. No API key needed.

  1. 01
    Choose a sample value

    Start with nike, or change the query field to your own value.

  2. 02
    Select Run sample

    Execute the sample code and see the response in the JSON response tab.

  3. 03
    Build on the result

    Open the full playground to try more parameters and copy code for your app.

Open this endpoint in the playground Request and response fields
LIVE SAMPLE / Search adsNo API key needed

Preparing the sample…

// Run this sample here — no API key needed.
const value = "nike";
const url = new URL("/website/demo/meta-ads",
  "https://api.scrapeatlas.com");
url.searchParams.set("value", value);

const response = await fetch(url);
const data = await response.json();
console.log(data);
GET/v1/facebook/adLibrary/search/ads

A live example from our playground. Change the value above, then select Run sample.

CUSTOMER STORIES

What they are saying
about us.

Digging your ScrapeAtlas experience?

Email Viktor with a testimonial & receive 10,000 free credits.

Nigel Yong — Founder, PostOnce

Pay as you go

Start free.
Build at your pace.

One-time credit packs, priced in US dollars. Credits never expire, and there is no monthly commitment.

Free

Try the API with your next idea.

$0No credit card needed

100 free credits

One starter grant per account

Starter

For a new idea or a one-off project.

$19USD / one-time

10,000 credits

$1.90 per 1,000 successful requests

Growth

Save 6.3%

For regular workflows and bigger builds.

$89USD / one-time

50,000 credits

$1.78 per 1,000 successful requests

Enterprise Plan

Want to scrape larger volumes?

Let’s talk about a plan that fits your scale.

Meta Ads Library API

Frequently Asked Questions

Explore the API reference

Meta Ads Library API and scraping

What advertising data does the Meta Ads Library API return?

Search public ads, find advertisers, browse a company’s creatives and retrieve individual ad details. Responses support creative research with media, advertiser information and transparency fields, with a separate video-transcript endpoint.

How do I use the Meta Ads Library scraper for Facebook ad research?

Search the library using the ad filters, or resolve a company with Find Advertisers and request its ads by page ID. Search and Company Ads support query-string or JSON-body requests and return continuation information for additional pages.

Can I search the Meta Ads Library with a JSON request body?

Yes. Ad Search has a POST operation that accepts the search parameters in a JSON body. It returns a page of ad records and continuation information, making it straightforward to connect a saved filter form to your application’s creative research workflow.

Meta Ads Library: advertiser research and transparency

Which transparency details can I retrieve from the Meta Ads Library?

Ad Details provides creative variants, payer and beneficiary information, and regional transparency fields. Use the ad record with its source reference when researching who is behind a campaign and the creative it displays.

Can I retrieve one advertiser’s ads from the Meta Ads Library API?

Yes. Find Advertisers returns company suggestions and page IDs. Pass a selected page ID to Company Ads, then follow continuation tokens. Compact Company Ads returns normalized archive records for an archive managed by your application.

Can the Meta Ads Library API return video ad transcripts?

Yes. Video Transcript returns speech text from an ad’s primary or carousel video. Ad Details also supports includeTranscript=true, so your application can keep the transcript with the creative record for message research.

API access and integration

How do I get a ScrapeAtlas API key and authenticate requests?

Create a ScrapeAtlas account and generate an API key in the dashboard. Send the key in the x-api-key request header when calling https://api.scrapeatlas.com. The API playground lets you enter an endpoint’s parameters and inspect its JSON response.

Can I call the scraping API from Python, JavaScript or the CLI?

Yes. Send authenticated HTTP requests from Python, JavaScript or another language that supports HTTP. The endpoint reference includes request examples and response fields. Use the ScrapeAtlas CLI for terminal workflows and pass the returned pagination values when requesting additional result pages.

Can I connect an AI assistant to the ScrapeAtlas MCP server?

Yes. Connect an MCP-compatible assistant to the ScrapeAtlas MCP server to discover and call the public platform tools with your ScrapeAtlas account. The agent reference also gives coding assistants a readable guide to the endpoints and their request schemas.

Make something with it

Ready to build?

Bring social data into your next project.
Start with 100 free credits and see what you can build.

Start building for free Explore pricing
No credit card needed.Building with an AI agent?