# Facebook Adlibrary Ad API (https://www.socialcrawl.dev/platforms/facebook/adlibrary-ad)

> Returns detailed information about a specific ad from the Facebook Ad Library — creative, spend, impressions, and targeting. For ad video transcripts, use `/v1/facebook/adlibrary/ad/transcript` (separate endpoint, premium tier).

TL;DR: `GET /v1/facebook/adlibrary/ad` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | Facebook Ad Library ad ID |
| `url` | no | Facebook Ad URL |
| `trim` | no | Set to true for a trimmed down version of the response |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/facebook/adlibrary/ad" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I fetch a Facebook Ad Library ad via API?

Send a GET request to /v1/facebook/adlibrary/ad with either the ad id or the Facebook Ad URL. SocialCrawl returns the ad creative, spend range, impressions range, targeting, start date, and advertiser info.

### What data does the Ad Library endpoint return?

Every ad includes the creative (text, images, video URL), advertiser page info, status, EU spend range, impressions bucket, targeting parameters, date range, and ad disclaimer. Covers political and commercial ads.

### How much does the Ad Library API cost?

Each Ad Library ad request costs 5 credits on the advanced tier. New accounts get 100 free credits with no credit card required — enough to pull 20 ad records before paying. Ideal for ad intelligence workflows.

### Can I get the video transcript for a video ad?

Yes. Pass get_transcript=true and the response will include the video transcript when the ad is under 2 minutes. Perfect for competitive copy analysis and finding winning hooks in competitor creatives.

### Does it include political and issue ads?

Yes. The endpoint returns both commercial and political/issue ads with full transparency data: funding entity, ad disclaimer, targeting criteria, and spend/impressions ranges reported by Meta.

See the full Facebook API: https://www.socialcrawl.dev/platforms/facebook

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to access the Facebook Ad Library via the SocialCrawl API
- What data does the Meta Ad Library API return?