# Facebook Advertiser Ad Library by Brand Name

> Facebook Advertiser Ad Library by Brand Name is a paid API for AI agents from ads.apitoll.cloud, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-11).

Fetches all live and recent Facebook/Instagram/Messenger/Threads ads from a specific brand advertiser, resolved by name, with full creative details and no Meta login required.

## Facts

- Endpoint: GET https://ads.apitoll.cloud/v1/ads/facebook/advertiser?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-advertiser-ad-library-by-brand-name-32caef14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z1buiPFCT5ktHdSKnQh3s

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-advertiser-ad-library-by-brand-name-32caef14
```

Example prompt: Pull all active Facebook and Instagram ads that Nike is running in the US right now — I want up to 30 results sorted by most recent, including their headlines, body copy, images, and destination links.

## When to prefer this

Use this endpoint when you know the brand name of a specific advertiser and want all their ads isolated to that one brand (not keyword search noise). Prefer over the keyword search sibling when you want brand-specific ad intelligence rather than topic-based discovery. Prefer over the page-ID-based sibling when you only have the brand name, not the Facebook page ID.

## Known failure modes

- Brand name cannot be resolved to a dominant Facebook page — returns empty or ambiguous match
- Advertiser has no ads in the requested period or country — returns empty list
- Meta Ad Library rate limits or access restrictions cause partial or failed results
- Invalid country code or unsupported enum value returns a 400 validation error
- Payment of 0.03 USDC not fulfilled via x402 — returns 402 Payment Required
- limit exceeds maximum of 60 — returns validation error

## How this service works

Facebook ads from a specific advertiser by brand name — every live and recent ad a brand runs across Facebook, Instagram, Messenger and Threads, isolated to that ONE advertiser (filters out the stray pages a name search pulls in; echoes resolvedPage to verify). Returns the full ad creative (headline, body copy, CTA + destination link, image and video URLs), run dates, and platform mix. No Meta login. Competitor ad intelligence for AI agents.

## Output

Returns a list of ads for the resolved brand page including: full creative text (headline, body, CTA), destination URL, image and video URLs, ad run dates, active/inactive status, platform distribution (Facebook, Instagram, Messenger, Threads), and optionally the resolved advertiser page identity (verified status, categories, profile pic).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "advertiser"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 60,
       "minimum": 1,
       "description": "Max ads to return (1-60)."
      },
      "period": {
       "enum": [
        "",
        "last24h",
        "last7d",
        "last14d",
        "last30d"
       ],
       "type": "string",
       "description": "Limit to ads active in this window. Blank = all time."
      },
      "ad_type": {
       "enum": [
        "all",
        "political_and_issue_ads",
        "housing_ads",
        "employment_ads",
        "credit_ads",
        "financial_products_and_services_ads"
       ],
       "type": "string",
       "description": "Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent)."
      },
      "country": {
       "type": "string",
       "description": "Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US."
      },
      "sort_by": {
       "enum": [
        "impressions_desc",
        "most_recent"
       ],
       "type": "string",
       "description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended)."
      },
      "platforms": {
       "type": "string",
       "description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all."
      },
      "advertiser": {
       "type": "string",
       "description": "Brand / advertiser NAME (e.g. Nike, Spotify, Samsung). Resolves to the dominant matching Facebook page. Defaults to a demo brand if omitted."
      },
      "media_type": {
       "enum": [
        "all",
        "image",
        "video",
        "meme",
        "image_and_meme",
        "none"
       ],
       "type": "string",
       "description": "Creative format filter."
      },
      "active_status": {
       "enum": [
        "all",
        "active",
        "inactive"
       ],
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ads": [
   {
    "title": "Just Do It",
    "pageId": "15087023444",
    "country": "US",
    "ctaText": "Shop Now",
    "ctaType": "SHOP_NOW",
    "linkUrl": "https://www.nike.com/launch",
    "bodyText": "Gear up for your next run. New arrivals now live.",
    "isActive": true,
    "pageName": "Nike",
    "imageUrls": [
     "https://scontent.xx.fbcdn.net/v/nike1.jpg"
    ],
    "scrapedAt": "2026-06-25T14:32:09Z",
    "sourceUrl": "https://www.facebook.com/ads/library/?q=Nike&search_type=keyword_unordered&country=US",
    "startDate": 1718000000,
    "adArchiveId": "9876543210987654",
    "daysRunning": 14,
    "linkUrlType": "destination",
    "displayFormat": "VIDEO",
    "templatedText": false,
    "mediaExpiresAt": "2026-06-29T22:19:28Z",
    "publisherPlatform": [
     "FACEBOOK",
     "INSTAGRAM"
    ]
   }
  ],
  "asOf": "2026-06-25T14:32:10Z",
  "count": 12,
  "query": {
   "advertiser": "Nike"
  },
  "source": {
   "via": "Apify",
   "name": "Facebook Ad Library"
  },
  "country": "US",
  "resolvedPage": {
   "pageId": "15087023444",
   "pageName": "Nike"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-advertiser-ad-library-by-brand-name-32caef14/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ads.apitoll.cloud](https://www.zero.xyz/host/ads.apitoll.cloud/llms.txt)