hookads

Free Resources

Every viral ad style, teardown, hook, and framework — free, in one place.

Ad Teardowns preview

Ad Teardowns

Real ads reverse-engineered — the hook, the mechanism, and why it works.

Explore
Case Studies preview

Case Studies

Documented real-brand campaigns with the actual numbers.

Explore
Swipe File preview

Swipe File

High-performing ads from around the web, broken down to steal.

Explore
Trend Radar preview

Trend Radar

What is scaling right now, updated every week.

Explore
Format Glossary preview

Format Glossary

Every ad format and marketing term, explained simply.

Explore
Guides preview

Guides

Deep-dive playbooks and frameworks for scaling ads.

Explore
Ad Templates preview

Ad Templates

3,400+ Canva-ready D2C ad templates — free with an account.

Explore
Products preview

Products

Playbooks and courses to put it all to work.

Explore
AI VideosAI ImagesHook BankPlaybooksToolsBlog
ProductsJoin free
hookads

The ad creative hub — every viral AI ad style, with the prompt behind it, free.

Free resources

AI Prompt LibraryHook BankAd TeardownsSwipe FileCase StudiesFree AI ToolsAd Library GuideAd Creative

Learn

PlaybooksGuidesTrend RadarFormat GlossaryMarketing GlossaryBlog

Company

AboutProductsMCP server for ClaudeFree Claude skillPricingContactMore from our teamThe Hook newsletter

Free ad tools

Ad spy toolFacebook ad spyCompetitor ad trackerAd analysis toolFacebook ad downloaderAd copy generatorAd headline generatorAd script generatorAd mockup generatorFacebook ad cost calculatorAd testing toolAll free ad tools

Ad libraries & examples

Ad librariesYouTube ad libraryPinterest ad librarySnapchat ad libraryLinkedIn ad libraryBing ad libraryAd examplesAd copy examplesUGC ad examplesCarousel ad examplesVideo ad examples

Solutions & templates

Solutions by audienceDropshipping video adsUGC ads for SaaSAI ad generator for ShopifyAd templatesCommercial script templateMarketing brief templateChatGPT prompts for adsCanva ad templatesDone-for-you ads

Compare ad tools

AlternativesReviewsHead-to-headPricing guidesAdSpy alternativesBigSpy alternativesZeely alternativesBest AI ad generators
© 2026 HookAds · All rights reserved.PrivacyTermsContactChrome Extension
Home/Free ad tools/Facebook Ad Library Scraper

Free ad tool

Facebook ad library scraper: export Meta Ad Library ads to CSV

This is the official route, not a scraper. Build a ready-made Meta Ad Library API request from your search terms and countries, run it with your own access token, then turn the JSON it returns into a CSV in your browser. Nothing is scraped from Meta and nothing is stored on our side.

Build your Ad Library API requestSee all free ad tools

Free, runs in your browser. Your API response never leaves this page.

facebook ad library scraper: Facebook Ad Library Scraper illustration

Ad Library export helper

API request builder and JSON to CSV

1. Build the API request

https://graph.facebook.com/v21.0/ads_archive?search_terms=YOUR+SEARCH+TERMS&ad_reached_countries=%5B%22US%22%5D&ad_active_status=ACTIVE&ad_type=ALL&fields=id%2Cpage_name%2Cad_delivery_start_time%2Cad_creative_bodies%2Cad_creative_link_titles%2Cad_snapshot_url%2Cpublisher_platforms&limit=50&access_token=YOUR_ACCESS_TOKEN

Replace YOUR_ACCESS_TOKEN with your own token. Never paste a token into a website. Use the current Graph API version from Meta's docs; v21.0 is an example. The official API has access requirements and does not return every ad (ordinary commercial ads outside the EU and UK are largely not available), so check Meta's Ad Library API page before you plan around it.

2. Turn the response into a CSV

Want the ad creatives themselves, not the data? The free Meta Ads Downloader saves images and videos from the Ad Library in one click.

How to export Meta Ad Library ads to CSV

  1. Enter your search terms, countries and active status. The tool writes the ads_archive request with the fields you need.
  2. Run the request with your own Meta access token, in a browser tab, curl or a script.
  3. Add the JSON the API returns to the converter and download the CSV.

Why this isn't a scraper

A scraper automates a website. This page doesn't touch Meta's site. It writes the documented request for the ads_archive endpoint of Meta's Graph API, the official route behind the FB Ad Library API, and then reshapes the JSON the API sends back into rows. The conversion happens in your browser, and your token stays with you.

That matters for two reasons. The request is stable, because it is the interface Meta publishes. And it comes with the API's own limits, which you should know before you build a workflow on it.

What the API covers, and what it leaves out

These points come from Meta's developer reference for the endpoint.

  • Access: a request needs an access token. Meta sets the access requirements for the Ad Library API and can change them, so read the current terms at facebook.com/ads/library/api before you rely on it.
  • Which ads: Meta's reference says ads that reached no location in the EU are returned only when they are about social issues, elections or politics. So the API covers far fewer ordinary commercial ads outside the EU than the website does.
  • Search: search_terms accepts up to 100 characters, and a blank space between words acts as AND. search_type can be set to exact phrase, ad_reached_countries takes ALL or country codes, and search_page_ids accepts up to ten Facebook Page IDs.
  • Status: ad_active_status defaults to ACTIVE, and INACTIVE and ALL are also available.
  • Fields: you can request ad_creative_bodies, ad_creative_link_titles, ad_delivery_start_time, ad_delivery_stop_time, ad_snapshot_url, page_name and publisher_platforms, among others.
  • Spend and targeting: spend and impressions are returned only for political and issue ads. Targeting fields cover ads delivered in the UK and EU, plus political ads in Brazil.

Facebook ad library API: get active ads for one competitor

To pull active ads for a single advertiser, add &search_page_ids=PAGE_ID (their Facebook Page ID) to the request URL the builder gives you, and leave ad_active_status on ACTIVE. Otherwise search_terms matches words inside ads, which is how you build a swipe file for a niche.

Once the CSV is open in Sheets or Excel, sort by ad_delivery_start_time, oldest first. The ads that started longest ago and are still active are the ones to study first, the same signal the Facebook ad spy page teaches you to read in the library. Then score the best few with the ad analysis tool.

Saving the images and videos

The CSV is for copy, dates and links. The ad_snapshot_url field gives you a link back to each ad. If you want the image or video file itself, use the free Meta ads downloader, a Chrome extension that adds a Download button to every ad card in the library.

Prefer to search without any API at all? The Ad Library search tool builds the website link with every filter set. File what you keep by mechanism in your swipe file, and remake the idea in your own creative instead of reusing theirs.

Frequently asked questions

Is there a free Facebook ad library scraper?

This page is the free, official alternative. It builds a Meta Ad Library API request and converts the response to CSV, without scraping Meta's website.

Does the Facebook Ad Library API need an access token?

Yes. Meta's example requests include one. Meta sets the access requirements and can change them, so check the current Ad Library API terms before you build on it.

Why does my API request return no ads?

Usually because of coverage. Meta's reference says ads that reached no location in the EU are returned only if they are about social issues, elections or politics. Also check that your search_terms are under 100 characters and your countries are valid.

Can I get ad spend and targeting from the API?

Only partly. Spend and impressions are returned for political and issue ads. Targeting fields cover ads delivered in the UK and EU, plus political ads in Brazil. For ordinary ads elsewhere, you get the creative and the dates.

Keep going: Facebook Ad Library Search, Instagram Ads Library, Facebook Ad Headline Generator, all free ad tools, the ad hook bank, and 3,000+ free Canva ad templates.

Related pages

Free ad toolsFacebook Ad Library SearchWants to search the Facebook Ad Library faster and with better filters (keyword, country, date range, media type,...Free ad toolsInstagram Ads LibraryWants to see the Reels, Story and feed ads a brand runs on Instagram specifically, to copy formats that work on...Free ad toolsFacebook Ad Headline GeneratorWants Facebook ad headlines that fit the 40-character display and grab attention under the creative.Free ad toolsAI Facebook Ad GeneratorDescribe your product and get a starter Facebook ad: hooks, headlines and calls to action that fit together, shown...Free ad toolsFacebook Lead Ads Testing ToolMeta's Lead Ads Testing Tool lives at developers.facebook.com/tools/lead-ads-testing. It creates a test lead on...Existing pagesFacebook Ad DownloaderFound an ad they like in the Facebook Ad Library or feed and wants to save the video or image file to their...Ad librariesSnapchat Ad LibrarySnapchat's closest thing to an ad library is the Snap Ads Gallery, a public repository of ads delivered in the...Ad librariesPinterest Ad LibraryPinterest does not publish a Meta-style ad library for everyone. It does publish an ads repository for ads shown...

Now make something from what you found

Take the angles you spotted into the AI Ad-Making Kit, or start with the free hook and copy tools.

Open the AI Ad-Making KitMore free ad tools