# GEDX402 Social – TikTok Ad Library Search

> GEDX402 Social – TikTok 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-09-14).

Search the TikTok Ad Library for ads by query, region, industry, format, and other filters via a paid proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok-ad-library/search
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-tiktok-ad-library-search-c9f194cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R2McRoYhlJjLW7YLKUrKn

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-tiktok-ad-library-search-c9f194cd
```

Example prompt: Search the TikTok Ad Library via SociaVault for up to 20 ads about 'weight loss supplements' targeting the US region in the health industry, ordered by likes, covering the last 30 days.

## When to prefer this

Use this endpoint when you need programmatic access to TikTok Ad Library data — for competitive ad research, trend analysis, or creative benchmarking — and want a simple per-call micropayment model without subscription overhead. Prefer over manual TikTok Ad Library browsing or other social data providers when you need structured JSON output with flexible filtering by region, industry, format, and objective.

## Known failure modes

- Payment not processed — x402 micropayment fails, endpoint returns 402
- Invalid region or ad_format enum value — returns error or empty data
- Query returns zero results for niche or overly specific search terms
- Cursor out of range — pagination fails with empty or error response
- Rate limiting or upstream TikTok Ad Library API unavailability

## How this service works

SociaVault social data ingest — profile, posts, transcript, and full API proxy. One x402 payment per outcome.

## Output

A JSON object with a 'data' field containing matching TikTok ad records (metadata, creatives, targeting info), a 'success' boolean, and provider attribution ('sociavault'). Results are paginated and support cursor-based navigation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "likes": {
   "type": "string"
  },
  "limit": {
   "type": "integer"
  },
  "query": {
   "type": "string"
  },
  "cursor": {
   "type": "integer"
  },
  "period": {
   "type": "string"
  },
  "region": {
   "type": "string"
  },
  "duration": {
   "type": "string"
  },
  "industry": {
   "type": "string"
  },
  "order_by": {
   "type": "string"
  },
  "ad_format": {
   "type": "string"
  },
  "objective": {
   "type": "string"
  },
  "ad_language": {
   "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-tiktok-ad-library-search-c9f194cd/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)