# ScrapeAdLibrary > ScrapeAdLibrary is a REST API over the public Meta Ad Library: search ads by keyword or advertiser with filters (country, status, media type, platform, language, dates), read the full detail of an ad with the EU (DSA) transparency data (reach, age, gender, locations), and look up advertiser pages and all their ads. 100 free credits per month, then from $1 per 1,000 credits; lists cost 1 credit per 10 items returned, only successful calls are billed and credits never expire. Not affiliated with Meta Platforms, Inc. Base URL: https://api.scrapeadlibrary.com/v1, authenticated with an API key (X-API-Key header or Authorization: Bearer). Official SDKs for Python and TypeScript, and an MCP server for AI assistants. Key facts: - Search ads: `GET https://api.scrapeadlibrary.com/v1/ads/search?q=nike&country=IT` - API keys start with `sal_` and are created in the dashboard: https://scrapeadlibrary.com/dashboard/api-keys - Python: `pip install scrapeadlibrary` ยท TypeScript/Node: `npm install scrapeadlibrary` - MCP server: `uvx scrapeadlibrary-mcp` (PyPI) ## Docs - [Getting started](https://scrapeadlibrary.com/docs): create an API key and search your first ads - [API reference](https://scrapeadlibrary.com/docs/api): every endpoint, parameter and response object - [Authentication](https://scrapeadlibrary.com/docs/authentication): API keys, X-API-Key and Bearer headers - [Code examples](https://scrapeadlibrary.com/docs/examples): cURL, Python and TypeScript examples - [Errors](https://scrapeadlibrary.com/docs/errors): HTTP status codes and error responses - [SDKs](https://scrapeadlibrary.com/docs/sdks): official Python and TypeScript SDKs - [MCP server](https://scrapeadlibrary.com/docs/mcp): Meta Ad Library data in Claude, Cursor and other MCP clients ## APIs - [Facebook Ads Search API](https://scrapeadlibrary.com/facebook-ads-search-api): Search the Ad Library by keyword or advertiser, with country, platform, media and date filters. - [Facebook Ad Details API](https://scrapeadlibrary.com/facebook-ad-details-api): One ad with its creatives, payers and EU (DSA) reach by country, age and gender. - [Facebook Page Ads API](https://scrapeadlibrary.com/facebook-page-ads-api): The profile of an advertiser page and every ad it runs, page by page. - [Facebook Advertiser Search API](https://scrapeadlibrary.com/facebook-advertiser-search-api): Find the advertisers that ran ads on a keyword, with their page ID and category. ## Pricing - [Pricing](https://scrapeadlibrary.com/pricing): free tier, per-item pricing and credit packs ## Optional - [Free Ad Library search](https://scrapeadlibrary.com/facebook-ad-library-search): search ads in the browser, no account, a few searches per day - [Full API reference for LLMs](https://scrapeadlibrary.com/llms-full.txt): the complete reference in one plain-text file - [Terms of Service](https://scrapeadlibrary.com/terms) - [Privacy Policy](https://scrapeadlibrary.com/privacy)