Facebook Ads Library Scraper | Ad Creatives
Pricing
from $0.30 / 1,000 ad results
Go to Apify Store
What is the difference between
Why is an ad row present without
Facebook Ads Library Scraper | Ad Creatives
Collect public Facebook-placement ads from Meta's Ad Library by keyword, Facebook Page ID, or page URL/alias. Export deduplicated ad copy, creatives, media, links, placements, and optional advertiser details to an Apify Dataset.
Pricing
from $0.30 / 1,000 ad results
Rating
0.0
(0)
Developer
DataScraperES
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Share
Collect public Facebook-placement ads from Meta's Ad Library by keyword, Facebook Page ID, page URL, or page alias. Each Dataset row keeps Meta's original ad snapshot and adds practical creative, media, placement, advertiser-page, pagination, and optional transparency data.
What this Actor does
The Actor searches Meta Ads Library results and follows pagination until it reaches your ad limit, the page budget, or the end of the available results. Every delivered ad must include Facebook in Meta's placement list. Ads may also appear on other Meta platforms; the original placement list remains complete.
Every ad row preserves the fields returned by Meta, including the ad archive ID, advertiser page, active state, dates, categories, spend and impression ranges when available, countries, placements, delivery restrictions, and the complete snapshot. The added creative object provides direct access to copy, headline, CTA, destination URL, image and video URLs, carousel cards, and page information without forcing you to traverse the raw snapshot. Optional detail enrichment adds advertiser transparency, payer and beneficiary data, page profile data, and EU/UK/Brazil audience information when Meta publishes it.
Use cases
- Monitor competitor ads, messaging, formats, landing pages, and placements by market.
- Build creative libraries containing copy, carousel variants, images, videos, dates, and CTAs.
- Research political, housing, employment, financial, or other Meta ad categories where the selected market exposes the corresponding data.
- Compare advertiser-page audience and verification signals with optional detail enrichment.
How to use
- Open the Actor in Apify Console.
- Enter a keyword, or use a numeric Page ID or Facebook page URL/alias, then choose the country and result limit.
- Enable Enrich ad details only when transparency and page-profile fields are needed.
- Click Start and open the Dataset when the run finishes.
Use this small starting input:
Input
At least one search target is required. Enter a keyword, a numeric Facebook Page ID, or a Facebook page URL/alias. These are alternative ways to choose the target; leave the other target fields empty. All other inputs are optional and use the defaults shown below.
Required search target
query: use a brand, advertiser, product, or exact phrase, such asikea,nike,seguros de hogar, or"black friday". Leave it empty when using a specific Page ID or Facebook page.pageId: use the numeric Facebook Page ID, such as244033170035, instead of a keyword. Do not paste a URL here.pageUrl: use a public Facebook page URL or alias, such ashttps://www.facebook.com/IKEASpainorIKEASpain, instead of a keyword. Use a Facebook page, not an Instagram profile URL.
The input form cannot mark these three alternatives as individually required, so the Actor validates the rule at run time and rejects an input where all three are empty.
Optional filters and limits
| Input | Default | What to enter |
|---|---|---|
country | ES | A two-letter Meta market code such as ES, US, GB, or FR; use ALL for every available country. Do not enter a full country name. |
activeStatus | ACTIVE | ACTIVE for currently running ads, INACTIVE for stopped ads, or ALL for both. |
mediaType | ALL | IMAGE, VIDEO, NONE for ads without image/video media, or ALL for every format. |
adType | ALL | EMPLOYMENT_ADS, FINANCIAL_PRODUCTS_AND_SERVICES_ADS, HOUSING_ADS, or POLITICAL_AND_ISSUE_ADS; availability depends on the market. The legacy CREDIT_ADS name is not a separate option. |
contentLanguages | empty | Select language codes from the dropdown, for example es, en, ca, or pt. Empty includes every language; the list also contains cmn and yue. |
startDate / endDate | empty | Optional date boundaries in YYYY-MM-DD, such as 2026-08-01 and 2026-09-30. Use either boundary or both; filtering is based on the ad's reported start date. |
maxAds | 100 | Number of unique ads to save, from 1 to 5,000. Each delivered ad triggers the ad and creative_details events. Use 1 for a quick test or 100 for a normal search. |
maxPages | 100 | Pagination safety limit, from one to five hundred pages. Use 1-2 for a quick test or 100+ for a broad search; the run can stop at this limit before reaching maxAds. |
includeDetails | false | Set true to request advertiser transparency, payer/beneficiary, audience, and page-profile details. Each successfully returned detail payload also triggers the advertiser_details event; unavailable, failed, or skipped details do not. |
detailsLimit | 25 | Maximum ads whose details are requested, from 1 to 5,000; unavailable or failed details count toward this limit. Used only when includeDetails is true. Use 1 to test enrichment. |
contentLanguages is a multi-select field. The platform is fixed to Facebook; supplying publisherPlatforms is rejected. The returned publisher_platform field can still contain every placement reported by Meta, even when a placement filter is used.
Output
The Dataset contains one row per deduplicated ad_archive_id. The raw Meta response remains under snapshot; use creative for common fields such as allTexts, format, linkUrl, ctaType, imageUrls, videoUrls, cardData, and the advertiser page. Optional details contains the extra transparency response, while enrichment records whether that ad was enriched, skipped, unavailable, or failed individually. collection records the filters and the page's delivery state; use RUN_SUMMARY for final pagination and completion.
Ads are saved as each page is processed. The default Key-value Store contains RUN_SUMMARY with the final status, saved counts, and pagination result. collectionComplete is true only when the requested ad limit or the end of the available results is reached. enrichmentComplete indicates whether the requested optional details completed without individual failures or spending restrictions. A partial status preserves useful ads while identifying unfinished work; it ends the Actor run without a successful completion status. A valid search with no matching ads can still succeed.
This is the complete Dataset item from a real successful run:
Pricing
Pricing is pay per event. Each unique ad delivered to the Dataset triggers both ad and creative_details. When optional advertiser enrichment returns data successfully, that ad also triggers advertiser_details. Each event is charged separately at the price for the customer's Apify plan; there is no minimum purchase of 1,000 events.
| Apify plan | ad price per event | ad equivalent per 1,000 events | creative_details price per event | creative_details equivalent per 1,000 events | advertiser_details price per event | advertiser_details equivalent per 1,000 events |
|---|---|---|---|---|---|---|
| FREE | $0.0004 | $0.40 | $0.0001 | $0.10 | $0.0004 | $0.40 |
| BRONZE | $0.00036 | $0.36 | $0.00009 | $0.09 | $0.00036 | $0.36 |
| SILVER | $0.00032 | $0.32 | $0.00008 | $0.08 | $0.00032 | $0.32 |
| GOLD | $0.0003 | $0.30 | $0.000075 | $0.075 | $0.0003 | $0.30 |
| PLATINUM | $0.0003 | $0.30 | $0.000075 | $0.075 | $0.0003 | $0.30 |
| DIAMOND | $0.0003 | $0.30 | $0.000075 | $0.075 | $0.0003 | $0.30 |
The base charge for one delivered ad is the sum of its ad and creative_details events: $0.0005 on FREE, equivalent to $0.50 per 1,000 delivered ads. If advertiser details are also returned, the FREE total is $0.0009 for that ad, equivalent to $0.90 per 1,000 fully enriched ads. For example, 25 base results cost $0.0125 on FREE; 25 results with successful advertiser enrichment cost $0.0225. These are comparison totals; billing still occurs event by event.
Empty searches, failed requests, discarded records, and unavailable, failed, or skipped optional details do not trigger their respective events. A run respects the maximum charge selected in Apify and may stop before reaching the requested ad or detail limit when the remaining budget cannot cover another event. Check the Pricing tab and maximum charge before starting.
Related Actors
| Actor | Best for |
|---|---|
| Meta Ads Library Scraper | All Meta Platforms | Searching ads across several Meta platforms with selectable placements. |
| Google Ads Transparency Center Creative Scraper | Comparing Facebook creatives with public Google advertiser creatives. |
| TikTok Commercial Content Library Ads Scraper | Extending ad research to public TikTok commercial content. |
Limits and data quality
The Actor can return only fields Meta publishes for the selected country, ad type, advertiser, and ad state. Spend, impressions, reach, demographic transparency, payer information, and profile metrics are conditional; null means the source did not provide that value. Estimated audience fields must be treated as estimates, not measured campaign performance.
Media URLs are supplied by Meta and can expire. The raw snapshot is kept so downstream users can inspect fields that are not yet represented in creative. Results are deduplicated by ad_archive_id. Each row's collection describes the page at delivery; use RUN_SUMMARY for final totals and completion. A page_budget termination means collection is partial because more matching ads may remain; exhausted means the source reported no next page. Content-language and special ad-type semantics remain Meta-defined and should not be interpreted as an independent language classifier or visual classifier.
Results depend on the availability of Meta's public library. If a search cannot be completed, the Actor reports a failed run instead of presenting it as a search with zero matching ads. Check the run status and RUN_SUMMARY before using the output. A successful run reaches maxAds or the end of the available results. Reaching maxPages while more results remain is reported as incomplete.
The Apify run log shows stage updates, saved ad and page counts, enrichment counts, and elapsed time. The status message provides a shorter progress summary.
Frequently asked questions
What is the difference between snapshot and creative?
snapshot is the complete source object returned for the ad. creative is a normalized convenience layer for copy, CTA, destination, media URLs, cards, and page information. Use snapshot when you need a field not listed in the convenience layer.
Why is an ad row present without details?
Details are optional and limited by detailsLimit, which counts ads whose details are requested, including unavailable or failed details. Meta may not publish detail data for every ad. Base ads remain saved when a detail fails; inspect enrichment.status for enriched, no_data, failed, or skipped, and check RUN_SUMMARY for incomplete optional work.
Responsible use
Use this Actor only for lawful research and respect Meta's terms, applicable privacy and intellectual-property rules, advertising regulations, and the rights of advertisers and audiences. Do not use collected data to harass people, evade access controls, or make unlawful decisions about individuals.
Support
Open an issue in the Actor's Issues tab with a reproducible input and the Apify run ID when a run behaves unexpectedly.
![Facebook Ad Library Scraper 📢 [No Login] Ads & Creatives avatar](https://images.apifyusercontent.com/OEqH2ZzxN0lDKSFSiLGI9c5jz6uK4byoZsrAU7BWtbE/rs:fill:76:76/cb:1/aHR0cHM6Ly9hcGlmeS1pbWFnZS11cGxvYWRzLXByb2QuczMudXMtZWFzdC0xLmFtYXpvbmF3cy5jb20vcnBUYTM3bzFjdGZkRldaazktYWN0b3ItSERiSjIwd0pheTRjWURLVGctV1k4Y1FaMDlqaC1sb2dvLnBuZw.webp){kind=avatar}
