# GEDX402 Social – TikTok Popular Videos

> GEDX402 Social – TikTok Popular Videos 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).

Fetches a paginated list of currently popular TikTok videos, filterable by country and time period, via the SociaVault proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/videos/popular
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-tiktok-popular-videos-ac2a3ba3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__rGUuykQefy794Zdq0mX5

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-popular-videos-ac2a3ba3
```

Example prompt: What are the most popular TikTok videos in the US right now? Show me page 1, sorted by popularity, for the past 7 days.

## When to prefer this

Use this endpoint when you need a ranked list of currently popular TikTok videos, optionally filtered by country and time window. Prefer this over scraping TikTok directly or using general social listening tools when you want structured, paginated video popularity data via a pay-per-call x402 model without subscription overhead.

## Known failure modes

- Invalid country code returns empty results or error
- Out-of-range page number may return empty data array
- Unsupported orderBy value may default or return error
- Payment failure (x402) results in 402 response before data is returned
- SociaVault upstream unavailability causes 503 or timeout

## 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 popular TikTok video records and a 'success' boolean, sourced from SociaVault's TikTok proxy. The data typically includes video metadata such as titles, play counts, and other engagement metrics for trending videos in the requested region and period.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer"
  },
  "period": {
   "type": "integer"
  },
  "orderBy": {
   "type": "string"
  },
  "countryCode": {
   "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-popular-videos-ac2a3ba3/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)