Meta Ads Library API

Meta ad data.
See what brands are putting in market.

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

PUT IT TO WORK

What will you build?

Three ways to use Meta Ads Library data.

Build a creative swipe file

Search ads in your category and collect examples for your next brief.

Review a brand’s ads

Retrieve an advertiser’s ads to compare offers, messages and creative formats.

Study the script

Read an ad’s video transcript to examine its opening, pitch and call to action.

YOUR FIRST REQUEST

Search ads.

Search ads in your category and collect examples for your next brief.

  1. 01
    Add your API key

    Set SCRAPEATLAS_API_KEY in your environment.

  2. 02
    Choose your input

    Use the sample request as a starting point.

  3. 03
    Work with the JSON

    Send the result to your app, sheet or research tool.

Request and response fields
QUICKSTART / API EXAMPLES
# ScrapeAtlas · use your customer API key
export BASE_URL="https://api.scrapeatlas.com"

curl --get "$BASE_URL/v1/facebook/adLibrary/search/ads" \
  -H "x-api-key: $SCRAPEATLAS_API_KEY" \
  --data-urlencode "query=running"
GET/v1/facebook/adLibrary/search/adsJSON response

Use your ScrapeAtlas API key. Replace the sample input with your own.

GETTING STARTED

A few practical details.

API key setup
How do I make a request?

Create a ScrapeAtlas API key, send it in the x-api-key header, and pass the endpoint’s request fields. The example above is ready to adapt to your own input.

What does the response contain?

Search the Meta Ad Library, read ad creatives and explore advertisers. Retrieve video transcripts for a closer look at the message. Each endpoint’s reference shows its response fields and a JSON example.

Can I use this from an AI assistant?

Yes. Connect ScrapeAtlas through MCP to use Meta Ads Library tools from your assistant. You can also call the same API from your own scripts or the CLI.