{"uid":"cap_o6kD21ixFce2Wr68XJK4-","slug":"api-direct-tiktok-music-videos-lookup-ea94cc6a","name":"API Direct – TikTok Music Videos Lookup","description":"Get the videos using a sound by music URL or numeric music ID.","url":"https://x402.apidirect.io/v1/tiktok/music/videos?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.007","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.007/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.007","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UHfiXw1Au46roPbxUV1wL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.007","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves TikTok videos that use a specific sound/music track, identified by music URL or numeric music ID, with optional AI sentiment analysis.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Track viral sound adoption","prompt":"Pull up the TikTok videos using music ID 7016547803243022337 and get me 5 pages of results so I can see how many creators are using that sound."},{"title":"Sentiment analysis of UGC for a branded sound","prompt":"I launched a branded TikTok sound at https://www.tiktok.com/music/MyBrand-Jingle-7123456789012345678 — fetch 2 pages of videos using it and turn on sentiment analysis so I can see how the audience is reacting emotionally."},{"title":"Competitor music trend research","prompt":"Show me the TikToks using the sound from https://www.tiktok.com/music/Trending-Song-7098765432109876543, just the first page, so I can see what content styles are performing with that audio."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:08:20.456Z","isFirstParty":false,"canonicalSlug":"api-direct-tiktok-music-videos-lookup-ea94cc6a"}