# GEDX402 Social — SociaVault TikTok Popular Creators

> GEDX402 Social — SociaVault TikTok Popular Creators 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).

Retrieves a paginated list of popular TikTok creators, filterable by follower count, creator country, and audience country, via the SociaVault data proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/creators/popular
- 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-sociavault-tiktok-popular-creators-161a4a4c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JAV3NUOM0gq2xVrErobdw

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-sociavault-tiktok-popular-creators-161a4a4c
```

Example prompt: Show me the most popular TikTok creators from the United States with over 1 million followers, sorted by follower count — pull the first page of results via SociaVault.

## When to prefer this

Use this endpoint when you need to discover or rank popular TikTok creators at scale with filters for follower count and geography, especially when you want SociaVault's aggregated creator data rather than scraping TikTok directly. Prefer this over general social APIs when TikTok-specific creator discovery with audience country targeting is the core need.

## Known failure modes

- Invalid or missing x402 payment header returns 402 Payment Required
- Invalid 'sortBy' value returns a 400 or empty result set
- Unsupported country code for creatorCountry or audienceCountry may return empty data
- Page number out of range returns empty data array
- Rate limiting or upstream SociaVault unavailability returns 5xx error

## 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 a list of popular TikTok creator profiles (likely including handles, follower counts, country info, and ranking signals), a 'success' boolean, and a 'provider' field confirming SociaVault as the data source.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer"
  },
  "sortBy": {
   "type": "string"
  },
  "followerCount": {
   "type": "string"
  },
  "creatorCountry": {
   "type": "string"
  },
  "audienceCountry": {
   "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-sociavault-tiktok-popular-creators-161a4a4c/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)