# SociaVault TikTok Popular Music Rankings

> SociaVault TikTok Popular Music Rankings is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.038/call, status unknown (last checked 2026-09-13).

Retrieves a ranked list of popular TikTok music tracks, filterable by time period, country, rank type, and commercial music status.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/music/popular
- Price: $0.038/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sociavault-tiktok-popular-music-rankings-f03d2000
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E4amNObPr1YUwpMm2_zvB

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 sociavault-tiktok-popular-music-rankings-f03d2000
```

Example prompt: Show me page 1 of the top-ranked popular TikTok music in the US for the past 7 days, including only commercial music that's newly on board, using SociaVault's TikTok music charts.

## When to prefer this

Use this endpoint when you need TikTok-specific music popularity rankings with flexible filtering by geography, time period, rank type, and commercial licensing. Prefer this over generic social media APIs when TikTok chart data with per-call x402 micropayment access is acceptable and you need structured music trend data without long-term subscription commitments.

## Known failure modes

- Invalid countryCode returns empty results or error
- Unsupported rankType or timePeriod string yields no data
- Payment not processed results in 402 response blocking access
- Page number out of range returns empty data array
- Network timeout or upstream TikTok data unavailability causes failure

## How this service works

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

## Output

Returns a JSON object with a success flag, provider name ('sociavault'), and a data payload containing paginated popular TikTok music tracks ranked according to the specified filters (rank type, time period, country, commercial status, new entries).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "integer"
  },
  "rankType": {
   "type": "string"
  },
  "newOnBoard": {
   "type": "boolean"
  },
  "timePeriod": {
   "type": "string"
  },
  "countryCode": {
   "type": "string"
  },
  "commercialMusic": {
   "type": "boolean"
  }
 }
}
```

## 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/sociavault-tiktok-popular-music-rankings-f03d2000/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)