# Facebook Ad Library Search

> Facebook Ad Library Search is a paid API for AI agents from Scrape Creators at mpp.orthogonal.com, paid per call via MPP, $0.02/call, status unknown (last checked 2026-10-12).

Searches the Facebook Ad Library for ads matching specified query terms, returning ad metadata and creative details.

## Facts

- Endpoint: GET https://mpp.orthogonal.com/scrapecreators/v1/facebook/adLibrary/search/ads?utm_source=zero.xyz
- Price: $0.02/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-12
- Success rate: 0% of calls made through Zero
- Activations on Zero: 3
- Provider: Scrape Creators
- Docs: https://docs.scrapecreators.com
- Website: https://scrapecreators.com
- Tags: social-media, tiktok, instagram, youtube, scraping, social, data
- Canonical page: https://www.zero.xyz/c/scrape-creators-facebook-ad-library-search-f5d82903
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Y22pH23g-ogWT_uDVfEns

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scrape-creators-facebook-ad-library-search-f5d82903
```

Example prompt: Search the Facebook Ad Library for active ads from Nike in the US — I want to see what campaigns they're currently running and their ad copy.

## When to prefer this

Use this endpoint when you need to programmatically search and extract ads from Facebook's Ad Library for competitive research, marketing analysis, or monitoring advertiser activity. Prefer this over manual browsing when you need structured data at scale or want to integrate Facebook ad data into a workflow.

## Known failure modes

- No ads found for the given query — returns empty results
- Invalid or unsupported country code — returns error
- Facebook Ad Library rate limiting or access restriction — returns error
- Malformed query parameters — returns 400-level error
- Ad Library temporarily unavailable — returns 5xx error

## How this service works

Search Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

## Output

Returns a list of Facebook ads matching the search query, including ad creative text, advertiser details, active/inactive status, estimated impressions range, spend range, ad start/end dates, and ad IDs from the Facebook Ad Library.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scrape-creators-facebook-ad-library-search-f5d82903/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.orthogonal.com](https://www.zero.xyz/host/mpp.orthogonal.com/llms.txt)