# Facebook Ad Library Company Search via SociaVault

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

Searches the Facebook Ad Library for companies by query string, returning advertiser and ad data via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/facebook-ad-library/search-companies
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Last successful call: 2026-07-17
- Success rate: 100% of calls made through Zero
- Rating: 4.7 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/facebook-ad-library-company-search-via-sociavault-04223a68
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hf_Jo1UJi--x1iz9DcbLR

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 facebook-ad-library-company-search-via-sociavault-04223a68
```

Example prompt: Search the Facebook Ad Library for companies matching 'Nike' and show me what advertisers come up.

## When to prefer this

Use this endpoint when you need to search the Facebook Ad Library for companies or advertisers by name, especially for competitive ad intelligence, brand monitoring, or ad transparency research — without needing direct Facebook API credentials.

## Known failure modes

- Empty or missing query string returns no results or validation error
- Company name not found in Facebook Ad Library returns empty data object
- x402 payment failure results in 402 response before data is returned
- Facebook Ad Library API rate limit or downtime causes upstream failure
- Ambiguous or very short query may return unrelated advertisers

## How this service works

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

## Output

Returns a JSON object with a 'data' field containing Facebook Ad Library company/advertiser results matching the query, a 'success' boolean, and provider attribution ('sociavault').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "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/facebook-ad-library-company-search-via-sociavault-04223a68/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)
