# GEDX402 Social – TikTok Music Details

> GEDX402 Social – TikTok Music Details 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 detailed metadata about a TikTok music/audio clip by its clip ID via the SociaVault proxy, billed per call via x402 micropayment.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/tiktok/music/details
- 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-tiktok-music-details-c01eb9ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MGkmqn-fW7UeuV1j9iHbr

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-music-details-c01eb9ca
```

Example prompt: Can you pull up the music details for TikTok audio clip ID 7234891023456789012 — I want to know the track name, artist, and any other metadata SociaVault has on it?

## When to prefer this

Use this endpoint when you need structured metadata about a specific TikTok music or audio clip identified by its clip ID, and you are already integrated with the x402 micropayment protocol. Prefer this over scraping TikTok directly or using other social APIs when you need a pay-per-call model without subscription overhead.

## Known failure modes

- Invalid or non-existent clipId returns empty data object or error
- x402 payment failure results in 402 response before data is returned
- TikTok clip may have been removed or made private, returning no data
- Rate limiting or upstream SociaVault API unavailability returns 5xx error
- Malformed clipId (wrong format) may return error or empty response

## 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 'data' field containing music/audio metadata for the specified TikTok clip, a 'success' boolean, and a 'provider' field indicating 'sociavault'. The data payload contains detailed information about the TikTok music clip such as title, artist, duration, and usage statistics.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "clipId": {
   "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-music-details-c01eb9ca/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)
