Facebook Ad Library ads
Returns ads from the Facebook Ad Library by keyword, advertiser page or Ad Library search link. Each ad includes its copy, creative media, landing link, run dates and the platforms it runs on. Useful for tracking what competitors and brands are advertising and how they present offers.
What you get
- Ad Library ID and link
- Advertiser page name, ID, link, categories and like count
- Ad body text, headline and call-to-action
- Destination link, caption and description
- Ad format, image links, video links and video previews
- Start and end dates, and whether the ad is active
- Platforms the ad runs on: Facebook, Instagram, Messenger, Audience Network
- Ad categories and whether the ad contains AI-generated media
- Spend range and impressions, when shown
- Number of ad variations and carousel cards
What it can do
- Search the Ad Library by keyword
- Collect ads from specific advertiser pages
- Reuse a filtered Ad Library search link
- Filter by country, active or inactive status, and image or video ads
- Limit to ads active within a date window
Limits
- Up to 5166 results per run
- At most 500 ads per keyword, page or link, and up to 20 of these per run
- Spend and impression figures appear only when the Ad Library shows them
- Only publicly visible data
Input options
| Field | What it does |
|---|---|
| searchQueries | Keywords to search; each runs as a separate search. |
| pageUrls | Facebook page links of advertisers to collect ads from. |
| adsLibraryUrls | Ad Library search links whose filters are reused. |
| country | Two-letter country code, or ALL for every country. |
| activeStatus | Show all, active or inactive ads. |
| mediaType | Show all ads, image ads only or video ads only. |
| onlyAdsNewerThan | Start of the date window, as a date or a span like 30 days. |
| maxAds | Maximum ads per keyword, page or link. |
Example
Ask your AI for the data in plain words and it picks this source. Developers can also call source procli_facebook_a directly through the REST API or MCP with an input like this:
{
"activeStatus": "all",
"adsLibraryUrls": [],
"country": "US",
"maxAds": 20,
"mediaType": "all",
"onlyAdsNewerThan": "",
"onlyAdsOlderThan": "",
"pageUrls": [],
"searchQueries": [
"shopify"
]
}How to use it
- Create an account at prolevelmax.com. New users receive $1 in sign-up credit after verifying their email (one per person). No card required.
- Connect your AI. In the Dashboard, open Get started → Coding tools and API → Generate setup instructions and paste the instructions into your AI (Claude, ChatGPT, Cursor, Codex and others). You can also add the MCP server
https://prolevelmax.com/mcpor call the REST API. - Request data. Your AI selects a source, quotes the price and runs it only after you confirm. Results are returned as structured JSON that the AI can format as a table or report.
FAQ
How is this source billed?
Per result: $0.0012/result + $0.015/run, min $0.02/run. Your AI quotes the price first, and you are never charged more than the quote.
Do I need a Facebook account or API key?
No. You only need a ProLevelMax account. One balance and one connection cover all 157 platforms.
Is the data real-time?
Yes. Every call fetches public Facebook data at the time of the request. Only publicly visible content is collected.
More Facebook sources
All Facebook sources and prices
New users receive $1 in sign-up credit after verifying their email (one per person). No card required. Pay per use with no subscription. Top up by card (USD) or Alipay (CNY); Enterprise top-ups from $1,000 by bank transfer.
Start for free