Meta Ad Library API for Facebook and Instagram ads

Search active and past ads by keyword or advertiser across countries, get creatives, copy, platforms and run dates, and EU transparency data of a single ad.

No credit card needed. One API key works on every endpoint.

Endpoints and prices

EndpointWhat you getPrice
GET /v1/ads/searchSearch ads5 credits / call$5 per 1,000 callsup to 30 ads per call
GET /v1/ads/{ad_id}Get an ad5 credits / call$5 per 1,000 calls
GET /v1/ads/pages/searchSearch advertisers5 credits / call$5 per 1,000 callsup to 10 advertisers per call
GET /v1/ads/pages/{page_id}Get an advertiser5 credits / call$5 per 1,000 calls
GET /v1/ads/pages/{page_id}/adsList an advertiser's ads5 credits / call$5 per 1,000 callsup to 30 ads per call

Make your first request

GEThttps://api.scrapecrate.com/v1/ads/search
curl "https://api.scrapecrate.com/v1/ads/search?q=running%20shoes" \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
  "data": [
    {
      "id": "1234567890123456",
      "url": "https://www.facebook.com/ads/library/?id=1234567890123456",
      "page": {
        "id": "102030405060708",
        "name": "Example Shoes"
      },
      "status": "active",
      "started_at": "2026-10-15",
      "platforms": [
        "facebook",
        "instagram"
      ],
      "format": "image",
      "body": "Run further with our new trainers.",
      "title": "New collection",
      "link_url": "https://example.com/shoes",
      "cta": {
        "text": "Shop now",
        "type": "SHOP_NOW"
      },
      "images": [
        {
          "type": "image",
          "url": "https://example.com/creative.jpg"
        }
      ]
    }
  ],
  "pagination": {
    "next_cursor": "eyJwIjoyfQ",
    "has_more": true
  },
  "meta": {
    "request_id": "req_8f2c1a9b0d3e4f5a6b7c",
    "credits_used": 5,
    "credits_remaining": 9999
  }
}

Illustrative values: a real response carries the live data you ask for.

What people build with it

Competitor ad research

See every active ad of a brand, with creatives, copy, call to action and start date.

Creative inspiration

Search ads by keyword and media type across countries to find what runs longest.

Political ad monitoring

Track political and issue ads with spend ranges, impressions and disclaimers.

Agency reporting

Export an advertiser's ads every week into your own dashboards.

Pricing

  • 5 credits per successful call on every endpoint, whatever it returns
  • $5 per 1,000 calls, volume packs down to half price
  • 100 free credits every month (20 calls), no credit card
  • Starter plan: 4.4k calls a month for $19
  • Only successful calls are billed
  • Credits are valid for 12 months and work on every API

See the full price list →

Also for AI assistants (MCP)

The ScrapeCrate MCP server exposes every endpoint of this API as a tool for Claude, Cursor and other MCP clients. Run it with uvx scrapecrate-mcp; see the MCP guide.

Frequently asked questions

Do I need a Meta developer account or identity verification?
No. You only need your API key; the data is the public Ad Library.
Which countries are covered?
Every country the Ad Library shows; use `country=ALL` or a two-letter code.
How are calls billed?
5 credits per successful call, whatever it returns: a page of up to 30 ads or one ad with its EU transparency data. The next page is a new call; errors are free.
How long do creative URLs last?
Image and video links are served by Meta's CDN and expire after a few days: download what you need to keep.
Am I charged for failed requests?
No. Only successful calls cost credits; errors, timeouts and not-found results are free.
Can I use the same API key for the other ScrapeCrate APIs?
Yes. One account, one API key and one credit balance work on every API: YouTube, Google Maps, Trustpilot, Meta Ad Library.

Start using the Meta Ad Library API

100 free credits every month. No credit card required.