Facebook Ad Library Scraper

Yes — Meta built the Ad Library so that anyone could look. Every ad in it is published on purpose, with no login and no paywall in the way, and collecting what is already on show is fair game. The full picture is in our guide to the legality of web scraping.

No login required. No account, no cookie, no Chrome extension to babysit — it reads the public Ad Library exactly as a stranger with a browser would. Nothing of yours is ever on the line, which is a nice way to research rivals.

100+ data points per ad. The advertiser and its page details, the whole creative — ad text, headline, call-to-action, images, videos, carousel cards — the destination link, the run dates, whether it is still live, the platforms it runs on and what Meta discloses about who paid for it.

Around 355 ads a minute. A keyword search is done in less time than it takes to open a competitor's website, so the afternoon goes on reading the creative rather than collecting it. Long advertiser exports keep the same pace.

Yes — any Ad Library address works. A keyword search, one advertiser's page, or a single ad on its own. Build the search you want on Meta's site, copy what is in the address bar, paste it in, and you are done choosing.

Roughly 400 to 550 per search — and that ceiling is Meta's, not ours. Meta stops serving results long before the total it advertises at the top of the page. To go deeper, slice the job: one advertiser, one country, one date window, one media type at a time.

Country, ad status, category, media type, platform, language, date range and sort order. Set them here, or bake them into the URL — whatever is already in the address bar wins, so a search you built on Meta's own site arrives exactly as you left it.

Yes, everything the transparency panel shows. Political and issue ads bring their spend and impression ranges, the declared payer and beneficiary, and EU reach by country, age and gender. It rides on the Ad Details add-on: 1 extra credit per ad.

Yes — direct links to every image and video. Each ad carries its media, plus the body, title and link of each card in carousel and catalogue ads. That is a whole swipe file in one export, and not a right-click in sight.

Just about anywhere you already work. Google Sheets, Make, n8n, Amazon S3, email, webhooks — plus our MCP server, so Claude or ChatGPT can start a run and read the ads back for you. CSV, Excel and JSON downloads too. See all integrations.

URL, such as https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=US&q=nike&search_type=keyword_unordered&media_type=all. Paste thousands at once or upload a CSV; duplicate inputs are skipped. 12 settings shape the run: see them in the playground.

109 data attributes per ad, each with its description and an example: see the full list.

No. Duplicates are removed, and you only pay for unique results.

As fresh as your run: each run collects the data from the site at the moment it runs, nothing comes from a stored database.

CSV, Excel or JSON from the dashboard, through the API, or sent after every run to Google Sheets, Amazon S3, an SFTP server, a webhook or by email.

7 days on the free plan, 28 days on paid plans. Then they are deleted. Download or deliver what you want to keep.

Around 355 ads a minute for one squid. Your plan's slots run several squids at the same time.

100.00% of its runs had no incident over the last 90 days (0 incidents, 100% fixed). Every day is on this page.

Our team fixes the scraper: every scraper on lobstr.io is built and maintained by us. How we measure.

Yes, on paid plans: every hour, every day, every weekday or on a custom schedule, in your time zone.

Yes: set the most results per task and per run in the settings. The run stops there and so does the bill.

1 credit per result. Options add to it: Ad Details +1. The playground shows the price as you pick them.

Yes. The free plan gives 100 credits every month, 100 results with this scraper, with exports capped at 30 rows.

Every month a plan gives credits, which pay for results, and slots, which set how many squids run at the same time. Starter: $20 for 10,000 credits; Pro: $100 for 100,000 credits; Team: $500 for 1,000,000 credits. Upgrades start right away and are prorated; downgrades and cancellations take effect at the end of the cycle.

No. Your credits refresh every month with your plan.

You choose, per squid: pause and pick up where it stopped, or end the run. To keep going, upgrade or reset your billing cycle: your plan renews right away and your credits come back. Auto Billing Reset does it for you when your usage crosses a threshold you set.

Yes: paying yearly takes 20% off every plan.

A monthly plan: within 10 days of the charge, if no credit was used in that period. A yearly plan: within 30 days, in full if no credit was used, otherwise minus one month. Cancel from your billing page, then write to contact@lobstr.io. The details are in the terms of use.

Collecting publicly available data is generally allowed, but you choose what you collect and you are responsible for how you use it. Our terms of use (article 6) ask every user to respect the rights of the sites, not to extract substantial parts of a database, not to access confidential data and to follow personal data law such as the GDPR. This is not legal advice.

When results contain personal data, you are the data controller and lobstr.io, a French company, processes them on your behalf, under our personal data agreement. You need a lawful basis for what you collect, must inform the people concerned and honor their requests.

Results: 7 days on the free plan, 28 days on paid plans, then they are deleted; you can delete them sooner. Your account data: see the privacy notice.

It depends on where the people are. In the EU, prospecting businesses by email is generally possible with an opt-out in every message, while consumers must have agreed first; calls follow each country’s do-not-call list. In the US, CAN-SPAM asks for your address and an opt-out in every email. This is not legal advice.

Yes, through the REST API at https://api.lobstr.io/v1, with your key from the dashboard. The playground’s Code tab writes the calls for your settings, in cURL and Python. The documentation has the full reference.

Yes. Add our MCP server, https://mcp.lobstr.io/mcp, to Claude, ChatGPT, Cursor or any MCP client and sign in with lobstr.io. Your agent shows the cost and asks you before a run spends credits. The playground’s Agent tab gives you a prompt.

No. Credits pay for results, not for requests.

Yes. Point a webhook at your server and lobstr.io calls it when a run succeeds or fails.

Yes, per endpoint: 120 requests a minute on squids and runs, 90 on tasks, 2 a second on results. Above that the API answers 429 with a Retry-After header.