# agdata Meta Ads Search

> agdata Meta Ads Search 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-14).

Search and retrieve live Meta (Facebook/Instagram) ad data by page, keyword, country, or active status

## Facts

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

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-c76b844a -d '<json body>'
```

Example prompt: Search the Meta ad library for active ads from the Nike Facebook page mentioning 'running shoes' in the US — show me up to 20 results.

## When to prefer this

Choose this endpoint when you need structured, machine-readable Meta ad data (Facebook/Instagram) without requiring a Meta developer account or ad account access. Ideal for competitive intelligence, ad monitoring, and brand research workflows that need to run autonomously via AI agents and pay per call in USDC with no subscription.

## Known failure modes

- Page name not found or misspelled — returns empty results
- Keyword too short (minimum 2 characters) — returns validation error
- Country code invalid — returns validation error
- Limit out of range (must be 1–100) — returns validation error
- Meta Ad Library rate-limited or temporarily unavailable — returns upstream 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 ad records, each containing the ad ID, body text, title, call-to-action label, destination URL, page name and ID, image URLs, platforms (Facebook/Instagram), display format (IMAGE, VIDEO, etc.), start and end dates, and whether the ad is currently active.

## 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-c76b844a/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)