# Facebook Ads Library Scraper

> Facebook Ads Library Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured ad data from Facebook's public Ad Library given page URLs, search URLs, or individual ad URLs

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/facebook-ads?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-ads-library-scraper-7b268e21
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rZYaMSBxRqs6pHdqWR20w

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 facebook-ads-library-scraper-7b268e21 -d '<json body>'
```

Example prompt: Pull up to 30 active Facebook ads from Nike's public page at https://www.facebook.com/nike — filter for US only and return the structured ad data including page name, archive IDs, and ad URLs.

## When to prefer this

Use this endpoint when you need structured JSON data from the Facebook Ad Library without managing browser automation or authentication. It is pay-per-call with no charge for failed or empty runs, making it cost-effective for ad intelligence tasks. Prefer it over manual scraping or browser-based tools when you need clean, schema-consistent output for competitive ad research.

## Known failure modes

- Empty result if the Facebook page has no ads or the URL is invalid
- HTTP 402 if payment is not provided
- Rate limiting or blocking if Facebook throttles public Ad Library access
- Schema mismatch if Facebook changes its Ad Library page structure
- Country filter may be ignored if the input URL already contains a country parameter

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object with a count of returned ads and an items array, where each item contains adUrl, pageId, pageUrl, inputUrl, pageName, adArchiveId, pageCategories, and pageProfilePictureUrl for each matched Facebook ad.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "country": {
   "type": "string",
   "default": "ALL",
   "description": "Country code such as US or GB, or ALL. Used only when the URL has no country parameter."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Maximum ads across every URL. Set 0 for no overall cap."
  },
  "startUrls": {
   "type": "array",
   "description": "Public Facebook page URLs, Ad Library search URLs, page-filter URLs, or individual ad URLs. Search URLs preserve their country, media, platform, and other URL filters."
  },
  "activeStatus": {
   "enum": [
    "all",
    "active",
    "inactive"
   ],
   "type": "string",
   "default": "all",
   "description": "Used when the URL has no active_status parameter. An existing URL setting takes priority."
  },
  "resultsLimit": {
   "type": "integer",
   "default": 30,
   "maximum": 30,
   "minimum": 1,
   "description": "Maximum ads to save for each URL. The public page currently exposes at most 30 without authenticated pagination."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "adUrl": null,
    "pageId": null,
    "pageUrl": null,
    "inputUrl": null,
    "pageName": null,
    "adArchiveId": null,
    "pageCategories": null,
    "pageProfilePictureUrl": null
   }
  ],
  "product": "facebook-ads"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-ads-library-scraper-7b268e21/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)