What is facebook-ad-library-scraper?

facebook-ad-library-scraper is a Python tool that automates pulling ad data out of Facebook's public Ad Library search results. Instead of manually browsing and copying information, you give it a search term and a country, and it builds the right Facebook Ad Library URL, opens it in a real Chrome browser using undetected-chromedriver, and scrolls down to load more results the way a person would. As it scrolls, the tool can save snapshots of the raw HTML pages to disk, which is useful if you want to reparse the data later without opening a browser again. It then reads through the ad cards on the page and pulls out details for each one: the advertiser page name and URL, the ad body text, any images, the call to action button and headline, the destination link the ad points to, and whether the ad shows a WhatsApp contact option. Duplicate ads are automatically removed before the results are saved. Results can be exported as a JSON file, a CSV file, or both, along with the saved HTML snapshots in their own folder. The project is available both as a command line tool, where you pass search filters like query, country, active status, media type, and date range as flags, and as a Python library, where functions like build_url, scrape, parse_ads, and parse_from_dir let you build the same workflow into your own scripts. Setup requires Python and Google Chrome installed locally, and the package will usually detect the right Chrome driver version automatically. Because the scraper depends on reading Facebook page structure directly, the README notes that its parsing logic may need updates if Facebook changes how its Ad Library pages are built.