Facebook Ad Library API: Complete Guide & Best Alternative (2026)

Meta first introduced the Ad Library in March 2019 in response to growing concerns about political advertising transparency following the 2016 US elections. The accompanying API was released shortly after, offering developers a way to query political and issue-based ads programmatically.

Over the years, the API has gone through several changes:

• Initially offered broad access to political ads globally
• Added social issue ads to the scope in 2020
• Restricted access to EU political ads starting in 2022
• Introduced stricter rate limiting in 2023
• Removed or deprecated several fields related to audience insights in 2024
• Currently requires identity verification for API access

These changes have made the API increasingly difficult to use for anything beyond narrow academic research on European political advertising.

According to Meta's documentation, the Ad Library API is intended for researchers, journalists, and organizations studying ad transparency. It is explicitly not designed for marketers, agencies, or businesses looking to analyze competitor ads or gather creative intelligence.

This fundamental design choice shapes every aspect of the API, from what data is available to how restrictive the access requirements are. If you are a marketer looking for competitive ad intelligence, the official Meta API is not built for you.

The most significant limitation is data scope. As of 2026, the Meta Ad Library API only provides access to political and social issue ads running in European Union countries. This means:

• No access to commercial/brand advertising data via the API
• No coverage of ads in the US, Canada, Australia, UK, or any non-EU country
• Only ads classified as political or issue-related are included
• No historical data for ads that have stopped running outside the EU

For marketers and agencies, this is a dealbreaker. The vast majority of ad intelligence use cases involve analyzing commercial brand ads across global markets, none of which is available through Meta's API.

Getting access to the Meta Ad Library API requires navigating a multi-step authentication and approval process:

1. Create a Facebook Developer account
1. Create a Facebook App and configure it for Marketing API access
1. Complete identity verification (government ID required)
1. Submit your app for Ad Library API review
1. Wait for approval (can take days to weeks)
1. Generate and manage long-lived access tokens
1. Handle token refresh logic in your application

This process is significantly more complex than most modern APIs, which typically use simple API key authentication. The identity verification requirement alone deters many potential users.

Meta imposes aggressive rate limits on the Ad Library API that make large-scale data collection impractical:

• Default rate limit of 200 calls per hour
• Pagination limits restrict the total number of results per query
• Bulk data export is not supported
• Rate limit headers are inconsistently applied
• Exceeding limits results in temporary blocks that can last hours

These limitations mean that even simple tasks like monitoring ads for a handful of competitors across multiple markets would quickly exhaust your API quota.

Even when you do get data back from the API, the available fields are surprisingly limited compared to what you can see in the web-based Ad Library:

• No creative performance data (no engagement metrics, impressions, or reach)
• Spending data provided only in broad ranges (e.g., "$100-$499")
• No audience targeting breakdown beyond basic demographics
• Image and video assets are not always accessible via returned URLs
• No information about landing pages or destination URLs
• Limited ad format metadata (no carousel slide data, no dynamic creative info)

• Full commercial ad data: Access any brand's ads, not just political ads
• Global coverage: Ads from every country and market, not just the EU
• Multi-platform: Facebook, Instagram, TikTok, Google, LinkedIn, X (Twitter), and more
• Simple authentication: API key-based auth, no identity verification needed
• Rich data: Creative assets, landing pages, ad copy, CTAs, and performance indicators
• Generous rate limits: Designed for production use at scale
• Real-time data: Access to currently running ads and recent historical data
• Clean JSON responses: Well-documented, consistent response format

The primary AdLibrary API endpoint for fetching brand ads is:

https://www.adlibrary.com/next/brand-ads

The API accepts the following query parameters:

• keyword — Search term to find ads (brand name, product, keyword)
• platform — Filter by platform: facebook, instagram, tiktok, google, linkedin, twitter
• geo — Country code filter (e.g., US, GB, DE, AU)
• adsType — Filter by ad type: image, video, carousel
• daysBack — Number of days to look back (e.g., 7, 30, 90)
• sortField — Sort results by: date, relevance, impressions
• pageSize — Number of results per page (default 10, max 50)

The AdLibrary API returns comprehensive ad data in clean JSON format. Each ad object includes:

• Ad creative text (headline, body, description)
• Creative assets (image URLs, video thumbnails)
• Landing page URL and call-to-action
• Platform and placement information
• Brand/advertiser details
• First seen and last seen dates
• Country targeting information
• Ad format and type classification

This rich data set enables a wide range of use cases from competitive benchmarking to creative inspiration workflows.

The simplest way to test the API is with cURL from your terminal:

curl "https://www.adlibrary.com/next/brand-ads?keyword=nike&platform=facebook&pageSize=10&geo=US"

This returns a JSON response with up to 10 Nike Facebook ads targeting the US market. You can pipe the output through jq for formatted results:

curl -s "https://www.adlibrary.com/next/brand-ads?keyword=nike&platform=facebook&pageSize=10" | jq ".data[0]"

Here is a Python script that fetches and processes ad data from the AdLibrary API:

import requests

params = {"keyword": "nike", "platform": "facebook", "pageSize": 10, "geo": "US", "daysBack": 30}

response = requests.get("https://www.adlibrary.com/next/brand-ads", params=params)

data = response.json()

for ad in data.get("data", []):

print(f"Headline: {ad.get('title', 'N/A')}")

print(f"Landing Page: {ad.get('landingPage', 'N/A')}")

print(f"First Seen: {ad.get('firstSeen', 'N/A')}")

print("---")

This script retrieves Nike's Facebook ads from the last 30 days in the US market and prints key details for each ad.

For JavaScript applications, you can use the Fetch API or any HTTP library:

const params = new URLSearchParams({ keyword: "nike", platform: "facebook", pageSize: "10", geo: "US", daysBack: "30" });

const response = await fetch(`https://www.adlibrary.com/next/brand-ads?${params}`);

const data = await response.json();

data.data.forEach(ad => { console.log(ad.title, ad.landingPage); });

The API returns standard JSON responses, making it trivial to integrate into any JavaScript application, whether it is a React dashboard, a Node.js backend, or a browser extension.

For large-scale data collection, you can paginate through results by adjusting the page parameter:

To retrieve all ads for a brand across multiple platforms, make parallel requests with different platform filters:

• First request: ?keyword=nike&platform=facebook&pageSize=50
• Second request: ?keyword=nike&platform=instagram&pageSize=50
• Third request: ?keyword=nike&platform=tiktok&pageSize=50

The API supports high request volumes with generous rate limits, making batch operations practical for enterprise use cases.

Track competitor ad strategies in real time. Monitor what creatives they are running, which platforms they prioritize, and how their messaging evolves over time. Use the API to build automated dashboards that compare your ad output against key competitors.

With the AdLibrary API, you can set up daily pulls for your top 10 competitors and automatically flag new creative launches, messaging pivots, or platform shifts.

Set up automated monitoring for specific brands, industries, or keywords. Receive alerts when competitors launch new campaigns, enter new markets, or test new ad formats. This is particularly valuable for agencies managing multiple client accounts.

Build a monitoring pipeline that checks for new ads every hour, compares against your historical data, and triggers Slack or email notifications when significant changes are detected.

Automatically collect and categorize high-performing ad creatives from brands you admire. Build searchable databases of creative inspiration organized by industry, platform, ad format, and messaging theme.

The API makes it easy to build internal swipe file tools that are always up to date with the latest ads from your industry.

Analyze advertising trends across industries and markets. Identify seasonal patterns, emerging platforms, and shifting messaging strategies. Use historical data to understand market dynamics and inform your advertising strategy.

By programmatically collecting ad data over time, you can build trend reports that show how advertising in your vertical evolves month over month.

Visit adlibrary.com and create a free account. You will get access to the API immediately after signup, no lengthy verification process required.

Navigate to your account settings to find your API key. This key is used to authenticate all API requests and tracks your usage against your plan limits.

Test the API with a simple request. Try searching for a well-known brand to verify your setup works correctly:

curl "https://www.adlibrary.com/next/brand-ads?keyword=coca-cola&platform=facebook&pageSize=5"

If you get a JSON response with ad data, your integration is working. From here, you can build out your application logic, set up scheduled data pulls, or integrate the API into your existing tools.

Once you have basic queries working, experiment with advanced parameters to refine your results:

• Combine platform and geo filters for market-specific insights
• Use daysBack to control the recency of results
• Adjust pageSize for performance optimization
• Use sortField to prioritize the most relevant results

The API documentation at adlibrary.com provides complete parameter references, response schemas, and additional code examples for every supported platform.