# Facebook Ad Library - Get Single Ad by Archive ID or URL

> Facebook Ad Library - Get Single Ad by Archive ID or URL is a paid API for AI agents from api.socialfetch.dev, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Fetches detailed data for a single Facebook Ad Library ad, given its archive ID or public Ad Library URL.

## Facts

- Endpoint: GET https://api.socialfetch.dev/v1/facebook/ad-library/ads
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-ad-library-get-single-ad-by-archive-id-or-url-c5b0aaf8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_s0Q4TibjoDZpVa98VgBU_

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-ad-library-get-single-ad-by-archive-id-or-url-c5b0aaf8
```

Example prompt: Can you pull the details for this Facebook Ad Library ad — https://www.facebook.com/ads/library/?id=1234567890 — and include the video transcript if there is one?

## When to prefer this

Use this endpoint when you have a specific Facebook Ad Library archive ID or public Ad Library URL and need structured metadata and creative data for that one ad. Prefer this over search endpoints when the exact ad is already known. Best for ad intelligence, political ad research, competitive analysis, or verifying ad details.

## Known failure modes

- Invalid or missing archive ID and URL returns an error
- Ad not found in the Ad Library (removed or non-existent)
- Rate limiting if too many requests are made in a short window
- Payment failure via x402 protocol blocks the request
- Ad Library URL is malformed or unrecognizable
- Video transcript unavailable even when includeTranscript is true

## How this service works

Get a single Facebook Ad Library ad by archive id or public Ad Library URL.

## Output

Returns structured data about a single Facebook Ad Library ad, including creative content, advertiser info, ad metadata, and optionally a plain-text transcript of the video if available. A trim option reduces payload size.

## 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",
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Public Facebook Ad Library URL for the ad."
      },
      "adId": {
       "type": "string",
       "maxLength": 4096,
       "minLength": 1,
       "description": "Facebook Ad Library archive id for the ad."
      },
      "trim": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "0",
          "1",
          "true",
          "false"
         ],
         "type": "string"
        }
       ],
       "description": "When true, requests a smaller payload before normalization."
      },
      "includeTranscript": {
       "anyOf": [
        {
         "type": "boolean"
        },
        {
         "enum": [
          "0",
          "1",
          "true",
          "false"
         ],
         "type": "string"
        }
       ],
       "description": "When true, includes a plain-text transcript when available for the ad video."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/facebook-ad-library-get-single-ad-by-archive-id-or-url-c5b0aaf8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.socialfetch.dev](https://www.zero.xyz/host/api.socialfetch.dev/llms.txt)