# GEDX402 Social – Google Ad Library Company Ads

> GEDX402 Social – Google 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-09-15).

Fetches ads run by a specific company from the Google Ad Library, filterable by topic, region, date range, and advertiser ID, via a pay-per-call x402 proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/google-ad-library/company-ads
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-google-ad-library-company-ads-48f68a9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wfzxkr_1w9mUhjKnj5sEW

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-google-ad-library-company-ads-48f68a9a
```

Example prompt: Pull all Google Ad Library ads run by Apple (advertiser ID 'AR123456789') in the US between January 1, 2024 and June 30, 2024 — I want to see what campaigns they've been running.

## When to prefer this

Use this endpoint when you need to programmatically access Google Ad Library data for a specific company or advertiser, especially for competitive intelligence, ad research, or transparency auditing. Prefer this over manual Google Ad Library browsing when automation or downstream data processing is needed. The x402 micropayment model makes it cost-effective for per-query lookups without a subscription.

## Known failure modes

- Missing required parameters (advertiser_id or domain) results in empty or error response
- Invalid date format for start_date/end_date causes query failure
- Unknown advertiser_id returns empty data set
- Payment failure via x402 returns 402 status before data is served
- Pagination cursor mismatch returns incorrect page of results
- Region code not recognized returns empty result set

## How this service works

SociaVault API proxy — google-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

Returns a JSON object with a 'data' field containing ad records from the Google Ad Library for the queried company, along with a 'success' boolean and 'provider' attribution ('sociavault'). May include pagination cursor for continued results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string"
  },
  "cursor": {
   "type": "string"
  },
  "domain": {
   "type": "string"
  },
  "region": {
   "type": "string"
  },
  "end_date": {
   "type": "string"
  },
  "start_date": {
   "type": "string"
  },
  "advertiser_id": {
   "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-google-ad-library-company-ads-48f68a9a/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)