# API Direct – TikTok Music Videos Lookup

> API Direct – TikTok Music Videos Lookup is a paid API for AI agents from x402.apidirect.io, paid per call via x402, $0.007/call, status unknown (last checked 2026-10-30).

Retrieves TikTok videos that use a specific sound/music track, identified by music URL or numeric music ID, with optional AI sentiment analysis.

## Facts

- Endpoint: GET https://x402.apidirect.io/v1/tiktok/music/videos?utm_source=zero.xyz
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-direct-tiktok-music-videos-lookup-ea94cc6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o6kD21ixFce2Wr68XJK4-

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 api-direct-tiktok-music-videos-lookup-ea94cc6a
```

Example prompt: Find me the TikTok videos using the sound at https://www.tiktok.com/music/Face-Off-7016547803243022337 — grab 3 pages of results and include AI emotion analysis for each video.

## When to prefer this

Use this endpoint when you need to enumerate TikTok videos tied to a specific audio track — useful for viral sound tracking, UGC monitoring, influencer research, or branded sound campaigns. Choose it over general TikTok search endpoints when the music URL or ID is already known. The optional sentiment analysis makes it uniquely suited for brand health or audience emotion research without needing a separate NLP call.

## Known failure modes

- Invalid or expired music URL returns an error or empty result set
- Providing both url and music_id simultaneously may cause validation error — only one should be supplied
- Music ID that does not exist on TikTok returns empty video list
- Pages value exceeding 1000 is rejected by schema validation
- Private or region-restricted sounds may return incomplete results
- Rate limiting or payment failure (x402) may result in 402 or 429 response

## How this service works

Get the videos using a sound by music URL or numeric music ID.

## Output

Returns a paginated list of TikTok video objects that use the specified music track. Each page contains up to 12 videos with metadata (video URL, author, play count, etc.). When get_sentiment is true, each video also includes a sentiment object with scores for eight emotions (joy, trust, fear, surprise, sadness, disgust, anger, anticipation each 0-100), a dominant_emotion, an emotional_intensity score (0-10), and a polarity label (positive, negative, or neutral).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "url": {
       "type": "string",
       "maxLength": 500,
       "description": "TikTok music URL, e.g. https://www.tiktok.com/music/Face-Off-7016547803243022337 (max 500 characters). Provide exactly one of url or music_id."
      },
      "pages": {
       "type": "integer",
       "default": 1,
       "maximum": 1000,
       "minimum": 1,
       "description": "Number of pages to fetch, 1-1000 (default: 1). Each page returns up to 12 videos."
      },
      "music_id": {
       "type": "string",
       "description": "Numeric music ID: the number at the end of a music URL, also returned as music_id on every video. Provide exactly one of url or music_id."
      },
      "get_sentiment": {
       "type": "boolean",
       "default": false,
       "description": "Set to true to add AI emotion analysis to each item. Adds a `sentiment` object containing `emotions` (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), `dominant_emotion`, `emotional_intensity` (0-10), and `polarity` (positive, negative or neutral). Any item t"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-direct-tiktok-music-videos-lookup-ea94cc6a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.apidirect.io](https://www.zero.xyz/host/x402.apidirect.io/llms.txt)