---
title: "Facebook Ad Library API: 4 endpoints, 1 credit per call"
description: "Get Facebook Ad Library data as structured JSON with one API key: search, advertisers, eu report and filters. Free credits every month."
url: https://perceptlayer.com/apis/facebook-ad-library
---

[APIs](https://perceptlayer.com/apis) / [Social media](https://perceptlayer.com/verticals/social) / Facebook Ad Library

1 credit per call 4 endpoints

# Facebook Ad Library API

Get Facebook Ad Library data as structured JSON with one API key: search, advertisers, eu report and filters. Free credits every month.

[Get a free API key](https://perceptlayer.com/signup) Run it below

Facebook Ad Library

GET /v1/facebook-ad-library/search?query=climate&country=US&ad\_type=POLITICAL\_AND\_ISSUE\_ADS 

```
curl "https://api.perceptlayer.com/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS" \
  -H "X-API-Key: $API_KEY"
```

cURL 1 credit per successful call

Run this call below or from your dashboard to see a live response.

Playground

## Run this API

cURL shell 

```
curl "https://api.perceptlayer.com/v1/facebook-ad-library/search?query=climate&country=US&ad_type=POLITICAL_AND_ISSUE_ADS" \
  -H "X-API-Key: $API_KEY"
```

Facebook Ad Library · 4 endpoints

## Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

Note 

Endpoints marked “Needs terms” return personal or social data. They work once you accept the [restricted-endpoint terms](https://perceptlayer.com/legal/restricted-endpoints) in your dashboard.

| Endpoint | Required parameters | Cost |
| --- | --- | --- |
| [GET `/v1/facebook-ad-library/advertisers`](https://perceptlayer.com/apis/facebook-ad-library/advertisers) | `query` +2 optional Needs terms | 1 credit |
| [GET `/v1/facebook-ad-library/eu-report`](https://perceptlayer.com/apis/facebook-ad-library/eu-report) | `section` +2 optional Needs terms | 1 credit |
| [GET `/v1/facebook-ad-library/filters`](https://perceptlayer.com/apis/facebook-ad-library/filters) | none +3 optional Needs terms | 1 credit |
| [GET `/v1/facebook-ad-library/search`](https://perceptlayer.com/apis/facebook-ad-library/search) | none +9 optional Needs terms | 1 credit |

Overview

## About the Facebook Ad Library API

## What you can get

The Facebook Ad Library API returns search, advertisers, eu report and filters as clean JSON. Each successful call costs one credit, and calls that fail are free.

Social media JSON REST MCP Some endpoints need terms

### More social media APIs

[Behance](https://perceptlayer.com/apis/behance) [Bilibili](https://perceptlayer.com/apis/bilibili) [Bluesky](https://perceptlayer.com/apis/bluesky) [Dailymotion](https://perceptlayer.com/apis/dailymotion) [DeviantArt](https://perceptlayer.com/apis/deviantart) [Dribbble](https://perceptlayer.com/apis/dribbble) [Facebook](https://perceptlayer.com/apis/facebook) [Flickr](https://perceptlayer.com/apis/flickr) [Hacker News](https://perceptlayer.com/apis/hacker-news) [Imgur](https://perceptlayer.com/apis/imgur) [Instagram](https://perceptlayer.com/apis/instagram) [Kick](https://perceptlayer.com/apis/kick)

Use cases

### Research the ads your competitors run

`Use the Facebook Ad Library API to research the ads your competitors run` 

### Track advertisers' activity over time

`Use the Facebook Ad Library API to track advertisers' activity over time` 

### Pull EU ad transparency reports

`Use the Facebook Ad Library API to pull EU ad transparency reports` 

FAQ

## Questions

**How much does the Facebook Ad Library API cost?**

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

**What format are responses in?**

Every endpoint returns JSON, with no HTML parsing on your side.

**Do I need a separate key for Facebook Ad Library?**

No. One key works for every API in the catalogue.

## Try the Facebook Ad Library API with 1,000 free credits

No credit card. Failed calls are never billed.

[Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)