# Facebook API

> Ads running on Facebook and Instagram, from Meta's Ad Library: copy, creative, landing page, dates and platforms.

- **Platform:** [Facebook](https://lurkapi.com/docs/facebook.md) (facebook.com/ads/library)
- **Web page:** https://lurkapi.com/docs/facebook

## Overview

Search Meta's public Ad Library by keyword or advertiser, and pull full detail for any ad. Great for competitor research, swipe files and creative trend tracking.

Source: facebook.com/ads/library.

## Try it live

Pick an endpoint and run it: real data, no signup, 5 free requests a day.

Live playground: https://lurkapi.com/docs/facebook#try

## Endpoints

- [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md): Find ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates. (GET /v1/facebook/adLibrary/search/ads · 1 credit)
- [Ad Library ads by company](https://lurkapi.com/docs/facebook/company-ads.md): Every ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library. (GET /v1/facebook/adLibrary/company/ads · 1 credit)
- [Ad Library ad details](https://lurkapi.com/docs/facebook/ad.md): Full detail for one ad from Meta's Ad Library, by its id or URL. (GET /v1/facebook/adLibrary/ad · 1 credit)
- [Search Ad Library companies](https://lurkapi.com/docs/facebook/search-companies.md): Find an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram. (GET /v1/facebook/adLibrary/search/companies · 1 credit)
- [Public profile](https://lurkapi.com/docs/facebook/profile.md): A Facebook Page's or public person's name, pictures, verification and follower counts. (GET /v1/facebook/profile · 1 credit)
- [Public post](https://lurkapi.com/docs/facebook/post.md): A public post's text, author, engagement counts and attached media. (GET /v1/facebook/post · 1 credit)

## Call it

Every endpoint is a `GET` with your key in the `x-api-key` header. For example, [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md):

curl:

```bash
curl "https://api.lurkapi.com/v1/facebook/adLibrary/search/ads?query=running+shoes&country=US&status=active" \
  -H "x-api-key: YOUR_API_KEY"
```

[Get a free API key](https://lurkapi.com/login?next=/dashboard)

## Use it in Claude

Once LurkAPI is [connected to Claude](https://lurkapi.com/docs.md#claude), each endpoint is a tool Claude can call:

| Tool | What it does |
| --- | --- |
| `facebook_search_ads` | [Search Ad Library ads](https://lurkapi.com/docs/facebook/search-ads.md): Find ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates. |
| `facebook_company_ads` | [Ad Library ads by company](https://lurkapi.com/docs/facebook/company-ads.md): Every ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library. |
| `facebook_ad` | [Ad Library ad details](https://lurkapi.com/docs/facebook/ad.md): Full detail for one ad from Meta's Ad Library, by its id or URL. |
| `facebook_search_companies` | [Search Ad Library companies](https://lurkapi.com/docs/facebook/search-companies.md): Find an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram. |
| `facebook_profile` | [Public profile](https://lurkapi.com/docs/facebook/profile.md): A Facebook Page's or public person's name, pictures, verification and follower counts. |
| `facebook_post` | [Public post](https://lurkapi.com/docs/facebook/post.md): A public post's text, author, engagement counts and attached media. |