# GEDX402 Social — Facebook Ad Library Company Ads

> GEDX402 Social — Facebook Ad Library Company Ads 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-21, last successful call 2026-07-17).

Retrieves Facebook Ad Library ads for a specific company, filtered by country, date range, media type, language, and ad status via SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/facebook-ad-library/company-ads?utm_source=zero.xyz
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- 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-company-ads-10a6b285
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dpxuB2mKQnd0Bu5RgBSYr

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-company-ads-10a6b285
```

Example prompt: Pull all active Facebook ads for Nike in the US from January 1 2024 to June 30 2024, including image and video media types, from the SociaVault Facebook Ad Library proxy.

## When to prefer this

Use this endpoint when you need to programmatically query the Facebook Ad Library for a specific company's ads and want pay-per-call pricing via x402 micro-payments, especially for competitive ad research, brand monitoring, or ad intelligence workflows where you need filtering by country, date, language, or media type.

## Known failure modes

- Invalid or unknown pageId returns empty data or error
- Invalid country code returns no results
- Date range with no ads returns empty data array
- Malformed cursor causes pagination failure
- Missing required companyName or pageId may return an error or empty result
- Network or upstream Facebook Ad Library outage causes proxy failure
- Payment failure (x402) blocks the request entirely

## How this service works

SociaVault API proxy — facebook-ad-library-company-ads. 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 Facebook Ad Library ad records for the specified company, including ad creatives, targeting details, and status information, plus a success flag and provider attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "trim": {
   "type": "boolean"
  },
  "cursor": {
   "type": "string"
  },
  "pageId": {
   "type": "string"
  },
  "status": {
   "type": "string"
  },
  "country": {
   "type": "string"
  },
  "end_date": {
   "type": "string"
  },
  "language": {
   "type": "string"
  },
  "media_type": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  },
  "companyName": {
   "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-company-ads-10a6b285/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)