# agdata Meta Ads Search API

> agdata Meta Ads Search API is a paid API for AI agents from agdata.shveik.dev, paid per call via x402, $0.03775/call, status unknown (last checked 2026-10-10).

Search and retrieve active or historical Meta (Facebook/Instagram) ads for a given page, keyword, or country as structured JSON

## Facts

- Endpoint: POST https://agdata.shveik.dev/v1/x402/meta-ads?utm_source=zero.xyz
- Price: $0.03775/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agdata-meta-ads-search-api-05491ff6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_03A-7denwoEyrcWg0wva5

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 agdata-meta-ads-search-api-05491ff6 -d '<json body>'
```

Example prompt: Can you pull up the active Meta ads for the Facebook page 'Nike' in the US — grab up to 50 results and filter for only the currently running ones?

## When to prefer this

Choose this endpoint when you need structured Meta (Facebook/Instagram) ad data — creatives, CTAs, targeting countries, active status — without scraping or a Meta developer account. Ideal for competitive intelligence, ad monitoring, and marketing research workflows that need programmatic access to the Meta Ad Library. Prefer it over general web scraping when you need clean, schema-consistent ad objects rather than raw HTML.

## Known failure modes

- Invalid or unknown page name returns empty results or 404
- Country code not recognized returns an error or empty set
- Keyword too short (under 2 chars) triggers schema validation rejection
- Limit out of range (0 or >100) triggers validation error
- Page has no ads in the Meta Ad Library returns empty array
- Payment failure or insufficient USDC balance returns 402 error

## How this service works

Unblock any URL as Markdown, or get search, social, maps, jobs and news as data. Paid per call in stablecoins over x402 or MPP, with no account.

## Output

Returns a JSON array of Meta ad objects, each containing the ad ID, ad text, title, call-to-action label, destination URL, the Facebook page name and ID, image URLs, platforms the ad ran on (Facebook, Instagram, etc.), display format (IMAGE, VIDEO, etc.), start and end dates, and an active boolean flag indicating whether the ad is currently live.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "string",
   "maxLength": 100,
   "minLength": 2
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "active": {
   "type": "boolean"
  },
  "country": {
   "type": "string"
  },
  "keyword": {
   "type": "string",
   "maxLength": 100,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cta": "Shop now",
  "adId": "12345678…",
  "text": "New seas…",
  "title": "Shop the…",
  "active": true,
  "pageId": "10000000…",
  "endDate": null,
  "linkUrl": "https://…",
  "pageName": "Example…",
  "imageUrls": [],
  "platforms": [],
  "startDate": "2026-09-…",
  "displayFormat": "IMAGE"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agdata-meta-ads-search-api-05491ff6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agdata.shveik.dev](https://www.zero.xyz/host/agdata.shveik.dev/llms.txt)