# GEDX402 Social – Facebook Ad Library Search

> GEDX402 Social – Facebook Ad Library Search is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.014/call, status unknown (last checked 2026-10-19, last successful call 2026-07-17).

Search Facebook's Ad Library for active or inactive ads by keyword, country, ad type, date range, and media type via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/facebook-ad-library/search?utm_source=zero.xyz
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Last successful call: 2026-07-17
- Success rate: 50% of calls made through Zero
- Rating: 1.3 / 5 from 1 review
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-facebook-ad-library-search-f0e4f2f9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5aoCMuB0GUvf4_khc-Avf

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 gedx402-social-facebook-ad-library-search-f0e4f2f9
```

Example prompt: Search the Facebook Ad Library for active video ads related to 'electric vehicles' running in the US between January 1 2024 and June 30 2024, sorted by relevance.

## When to prefer this

Use this endpoint when you need programmatic access to the Facebook Ad Library to research competitor ads, monitor political advertising, or gather creative intelligence by keyword and country filter — especially when you want pay-per-call pricing via x402 without a monthly subscription.

## Known failure modes

- No ads found matching the query — empty data object returned with success: true
- Invalid country code or ad_type value — may return error or empty results
- Cursor expired or malformed — pagination fails
- Payment not processed — x402 payment required before response is delivered
- Rate limit or upstream Facebook Ad Library unavailability — upstream error propagated

## How this service works

SociaVault API proxy — facebook-ad-library-search. Query/body matches https://docs.sociavault.com/api-reference/openapi.json. GET/POST per route; x402 per call. $0.014 USDC per request.

## Output

A JSON object with a 'data' field containing matching Facebook ad records from the Ad Library, a 'success' boolean, and a 'provider' string set to 'sociavault'. Ads include metadata such as creative details, status, and targeting. Results may include a cursor for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "trim": {
   "type": "boolean"
  },
  "query": {
   "type": "string"
  },
  "cursor": {
   "type": "string"
  },
  "status": {
   "type": "string"
  },
  "ad_type": {
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "sort_by": {
   "type": "string"
  },
  "end_date": {
   "type": "string"
  },
  "media_type": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  },
  "search_type": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "provider": "sociavault"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-social-facebook-ad-library-search-f0e4f2f9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.gedx402.com](https://www.zero.xyz/host/social.gedx402.com/llms.txt)