---
title: "Meta Ad Library API · SocialToAI"
canonical: https://socialtoai.app/platforms/meta/
updated: 2026-10-30
---

# Meta Ad Library API

The Meta Ad Library API lets you search ads by keyword, list an advertiser's ads, find advertisers, read one ad and get the transcript of an ad's video, with no Meta Ad Library account or login. Each call costs 2 credits ($0.004 to $0.0067); failed calls are free. Use it over HTTP with an API key, or through MCP from your AI client. Last tested 2026-11-15.

- Page: https://socialtoai.app/platforms/meta/
- Last updated: 2026-10-30
- Last tested: 2026-11-15

Meta Ad Library has none of the 6 shared actions (search, trending, detail, comments, user_profile and user_posts). Every interface here is called by its own op, through POST /v1/call/{op}.

Lighter for your AI: across 5 interfaces measured on the same recorded data, the platform's raw JSON is about 236,356 tokens and SocialToAI's answers about 79,078, 66% fewer (2026-11-06; the method is on the "How we measure" page).

## Example call

```bash
curl https://socialtoai.app/v1/call/meta.ad_search \
  -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "running shoes"
  }'
```

## Only on Meta Ad Library

Each one is called by its own op, through `POST /v1/call/{op}`; its full parameters and response fields are on its own page.

### Ads

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| Ad Library search | Search the ads running now in the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword. | `meta.ad_search` | 2 | [Meta Ad Library search API](https://socialtoai.app/meta-ad-search-api.md) |
| Advertiser's ads | Get the ads an advertiser (a Facebook page) is running now in the Meta Ad Library, by the page's ID. | `meta.advertiser_ads` | 2 | [Meta advertiser's ads API](https://socialtoai.app/meta-advertiser-ads-api.md) |
| Advertiser search | Find advertisers (Facebook pages) in the Meta Ad Library by name. | `meta.advertiser_search` | 2 | [Meta advertiser search API](https://socialtoai.app/meta-advertiser-search-api.md) |
| Ad detail | Get one ad of the Meta Ad Library by its library ID or link. | `meta.ad_detail` | 2 | [Meta ad detail API](https://socialtoai.app/meta-ad-detail-api.md) |
| Ad video transcript | Get what is said in the video of a Meta Ad Library ad by its library ID or link, as one text. | `meta.ad_transcript` | 2 | [Meta ad video transcript API](https://socialtoai.app/meta-ad-transcript-api.md) |

## Official API

Meta offers the official Ad Library API for searching ads about social issues, elections or politics delivered anywhere, and any ads delivered in the UK and EU. Access requires a Facebook account, confirming your identity and location, and a Meta developer account with an app.

Source: [Meta Ad Library's developer documentation](https://www.facebook.com/ads/library/api/), checked 2026-10-17.

[Meta Ad Library official API: access, prices and limits](https://socialtoai.app/does-meta-have-an-api.md)
