# Meta Ad Library Search via SiteCheck Shop & Social

> Meta Ad Library Search via SiteCheck Shop & Social is a paid API for AI agents from api.shopsocial-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Searches Meta's Ad Library API by keyword or Facebook page IDs and country, returning ad metadata including creative text, spend/impression ranges, delivery dates, and platform info.

## Facts

- Endpoint: GET https://api.shopsocial-api.workers.dev/api/social/facebook-ads-library?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/meta-ad-library-search-via-sitecheck-shop-social-52fcfd59
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3LKDLnL8PJSMovLPMBvOx

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 meta-ad-library-search-via-sitecheck-shop-social-52fcfd59
```

Example prompt: Can you pull up all active Facebook ads mentioning 'climate change' that were delivered in the US from Meta's Ad Library — political and issue ads only, show me up to 20 results?

## When to prefer this

Use this endpoint when you need to search Meta's Ad Library for ads by keyword or specific Facebook page IDs, especially for political/issue ad transparency research, competitive intelligence, or EU advertising compliance. Prefer it over general web scraping when you need structured ad metadata including spend ranges, impression data, and creative text directly from Meta's official data source. Requires a free Meta Ad Library API token from the operator.

## Known failure modes

- Missing or invalid Ad Library API token returns an authentication error
- Country code not recognized returns empty or error response
- pageIds exceeding 10 entries may be rejected
- adType=ALL with a non-EU/UK country returns empty results since ALL only works for EU/UK
- No matching ads found returns empty list with no error
- Rate limits from Meta's underlying API may cause failures
- Invalid q or pageIds format may return an error or empty results

## How this service works

Pay-per-call e-commerce, product, price and social media data tools for AI agents, from public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns a list of ads matching the query, each containing: ad ID, Facebook page name and ID, funding entity/byline, ad creation and delivery dates, creative text (titles, body, captions), snapshot URL, platforms delivered on, languages, and for political/issue ads the spend and impression ranges. EU ads also include estimated EU reach figures.

## 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": [],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search words (or use pageIds)"
      },
      "limit": {
       "type": "string",
       "description": "1 to 50 ads (default 10)"
      },
      "adType": {
       "type": "string",
       "description": "ALL or POLITICAL_AND_ISSUE_ADS (default). ALL only returns ads for EU/UK countries"
      },
      "country": {
       "type": "string",
       "description": "Two-letter country the ads reached, e.g. US, DE (ALL for every country)"
      },
      "pageIds": {
       "type": "string",
       "description": "Up to 10 Facebook page IDs, comma separated"
      },
      "activeStatus": {
       "type": "string",
       "description": "ACTIVE, INACTIVE or ALL (default ALL)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/meta-ad-library-search-via-sitecheck-shop-social-52fcfd59/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.shopsocial-api.workers.dev](https://www.zero.xyz/host/api.shopsocial-api.workers.dev/llms.txt)