TikTok Music detail API
Read the details of one TikTok sound by music_id: title, author_name, album, use_count, is_original and is_copyrighted, for $0.56 per 1,000 calls.
music_idalso takes the sound page link https://www.tiktok.com/music/<name>-<ID>- One call reads one sound and returns one object
- Failed calls and empty results are not charged.
API health
- 24h health
- Normal
- Healthy / normal
- Available
Last 24 hours
Last 30 days
1Request
POST /api/v1/social { "platform": "tiktok", "action": "music_detail", "params": { "music_id": "7252896191606835201" } }2JSON response
{ "results": { "author_name": "T•••t", "title": "Enchanted (Taylor's Version)", "album": "Speak Now (Taylor's Version)", "duration_seconds": 60, … } }3Fields
author_name title album duration_seconds T•••t Enchanted (Taylor's Version) Speak Now (Taylor's Version) 60 4CSV
tiktok-music_detail-sample.csv id,url,title,author_name,author_username,author_id,author_sec_uid,album,duration_seconds,duration_sec,use_count,is_original,is_commercial,is_copyrighted,is_private,cover_image_url,audio_url,platform
music_id goes in, and one JSON object comes back with fields such as title and use_count, listed as a field table and a CSV file.What data you get
The table shows a real call for 7252896191606835201, captured November 21, 2026 at 07:21 (UTC), that returned one object; gray bars mark removed personal information (••• in the CSV). Your own calls return these fields as listed in the field reference.
| id | url | title | author_name | author_username | author_id | author_sec_uid | album | duration_seconds | duration_sec | use_count | is_original | is_commercial | is_copyrighted | is_private | cover_image_url | audio_url | platform |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| https://www.tiktok.com/music/Enchanted-(Taylor's-Version)-7252896191606835201 | Enchanted (Taylor's Version) | T•••t | null | null | null | Speak Now (Taylor's Version) | 60 | 60 | 439400 | false | null | true | null | https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ooblA8sF6kVQIgDoS6ZeutinBeACpIZPVEQCAB~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=81f88b70&idc=useast5 | https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oQMfgHZ2yCAQeFFzvD7YinadqsaaALfRnJ4DEg | tiktok |
Use cases
Check how much a sound is used
Read
use_countto see how many videos used the sound, and read it again later to compare.Read the copyright and library flags
is_copyrightedmarks whether the music is protected by copyright,is_commercialmarks whether it is in the commercial library, andis_privatemarks whether it is private.Find the author of an original sound
Read
author_usernameandauthor_id. Original sounds also carryauthor_sec_uid, so you can read that account next.Get the album and a preview link
Read
album,duration_secondsandaudio_url.
Limits and gotchas
music_idis required. It is a music ID (theidof amusic_searchormusic_chartrow, or the id insidemusicof a video row), or a sound page link.author_sec_uidexists only for original sounds.use_countis the number of videos that used this sound.audio_urlis signed and expires, so do not keep it for the long term.
Pricing
You pay $0.000556 per call. One call reads one result. Failed calls and empty results are not charged.
| Calls | Cost |
|---|---|
| 10,000 | $5.56 |
| 100,000 | $55.56 |
| 1,000,000 | $555.56 |
Totals use the list price per call.
Code samples
#curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "tiktok",
"action": "music_detail",
"params": {
"music_id": "7252896191606835201"
}
}'OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.
API reference
See the parameters, response fields, errors and billing for music_detail, and copy the page or open it as Markdown for an AI assistant.
AI prompt
#Please help me write a data collection script with the EveryInfra TikTok Music detail endpoint (tiktok/music_detail).
How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to tiktok and action to music_detail, and put the parameters inside params.
- Required parameters:
- music_id: A numeric music ID, such as the id from music_search or music_chart or a video's music.id, or a https://www.tiktok.com/music/<name>-<ID> link.
- Returns one object. Main fields: id, url, title, author_name, author_username, author_id, author_sec_uid, album, duration_seconds, duration_sec, use_count, is_original; 17 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok.
- Example request body:
{
"platform": "tiktok",
"action": "music_detail",
"params": {
"music_id": "7252896191606835201"
}
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.
Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.Request parameters
#| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
Authorization | header | string | Yes | - | Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository. |
platform | body | string | Yes | tiktok | Platform identifier, fixed value. |
action | body | string | Yes | music_detail | Capability identifier, fixed value. |
music_id | body.params | string | Yes | - | A numeric music ID, such as the id from music_search or music_chart or a video's music.id, or a https://www.tiktok.com/music/<name>-<ID> link. |
Response example
#{ "id": "req_…", "platform": "tiktok", "action": "music_detail", "results": { "id": "•••", "url": "https://www.tiktok.com/music/Enchanted-(Taylor's-Version)-7252896191606835201", "title": "Enchanted (Taylor's Version)", "author_name": "T•••t", "album": "Speak Now (Taylor's Version)", "duration_seconds": 60, "use_count": 439400, "is_original": false, "is_copyrighted": true, "cover_image_url": "https://p16-common.tiktokcdn-us.com/tos-alisg-v-2774/ooblA8sF6kVQIgDoS6ZeutinBeACpIZPVEQCAB~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=81f88b70&idc=useast5", "audio_url": "https://sf16.tiktokcdn-us.com/obj/tos-alisg-ve-2774/oQMfgHZ2yCAQeFFzvD7YinadqsaaALfRnJ4DEg", "platform": "tiktok", "duration_sec": 60 }, "billing": { "charged": …, "charged_usd": …, "balance_after_usd": …, … }, "quota": { … }}
Response fields
#Business data is in results. The table lists the fields a record can contain. Values the platform does not show are never made up.
| Field | Meaning |
|---|---|
id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
url | Link to the record on the platform. |
title | Title. null when the platform has no titles (for example text-only posts). |
author_name | Author's display name. |
author_username | Author's username (@handle), usually usable in URLs. |
author_id | Author's unique ID on the platform. |
author_sec_uid | Keeps the platform's own meaning |
album | Keeps the platform's own meaning |
duration_seconds | Duration in seconds. null for content that is not video or audio. |
duration_sec | Keeps the platform's own meaning |
use_count | Keeps the platform's own meaning |
is_original | Keeps the platform's own meaning |
is_commercial | Keeps the platform's own meaning |
is_copyrighted | Keeps the platform's own meaning |
is_private | Keeps the platform's own meaning |
cover_image_url | Keeps the platform's own meaning |
audio_url | Keeps the platform's own meaning |
platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
Errors and billing
#- 401
- Missing or invalid key.
- 402
- Insufficient balance. Top up first.
- 422
- Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
- 429
- Per-minute request limit reached. Wait for Retry-After, then try again.
- 503
- Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
- 200 empty
- No data. No charge.
FAQ
Which fields does the music details API return?
id, url, title, author_name, author_username, author_id, author_sec_uid, album, duration_seconds, use_count, is_original, is_commercial, is_copyrighted, is_private, cover_image_url and audio_url.
Where do I get the music ID?
Take it from the id of a music_search or music_chart row, from the id inside music of a video row, or paste the sound page link.
How much does it cost to read the details of one sound?
It costs $0.000556 per call, or $0.56 per 1,000 calls. One call reads one result. Failed calls and empty results are not charged.
Related TikTok endpoints
You can call the other TikTok endpoints with the same EveryInfra API key, for example sound_videos.
- Search
search$0.56 per 1,000 callsSearch TikTok by keyword across the video, account or top tab. - Details
profile$0.56 per 1,000 callsLook up a TikTok account by handle. - Videos by user
user_videos$0.56 per 1,000 callsList a TikTok creator's videos with caption, publish time and like, comment, share and view counts. - Video details
video$0.56 per 1,000 callsFetch one TikTok video's caption, author, publish time and like, comment, share and view counts from its URL. - Comments
comments$0.56 per 1,000 callsRead the comments on a TikTok video. - Hashtag
hashtag$0.56 per 1,000 callsBrowse TikTok videos posted under a hashtag. - Followers
followers$0.56 per 1,000 callsCheck a TikTok account's follower, following, post and like totals by handle, with a precision flag for rounded numbers. - Transcript
transcript$0.56 per 1,000 callsExtract the transcript of a TikTok video from its URL. - Shop product search
shop_search$0.56 per 1,000 callsFind TikTok Shop products by keyword. - Shop creator details
shop_creator$0.56 per 1,000 callsSize up a TikTok Shop creator by handle. - Hashtag search
hashtag_search$0.81 per 1,000 callsSearch TikTok hashtags bykeyword. - Music search
music_search$0.81 per 1,000 callsSearch TikTok's sound library bykeyword, such as a song or artist. - Music chart
music_chart$0.81 per 1,000 callsRead a TikTok music chart:top50(default) orviral50. - Account search
user_search$0.56 per 1,000 callsSearch TikTok accounts bykeyword, in the order TikTok search ranks them. - Videos using a sound
sound_videos$0.56 per 1,000 callsList the TikTok videos that use one sound, from itsmusic_idor sound page link. - Comment replies
comment_replies$0.56 per 1,000 callsRead the replies under one comment on a TikTok video, from the videourland the comment'sidreturned bycomments. - Shop best sellers
shop_hot_products$0.81 per 1,000 callsRead the TikTok Shop best-seller list for one market: ID, JP, MX, MY (default), PH, SG, TH or VN. - Shop products by category
shop_category_products$0.81 per 1,000 callsList TikTok Shop products in one category bycategory_id, such as 601450 for beauty and personal care, in a chosen market. - Following
following$0.64 per 1,000 callsList the accounts a TikTok user follows, by handle. - Video download links
video_download$0.64 per 1,000 callsGet the download links for one TikTok video from itsurl, without the watermark. - Live room
live_room$0.81 per 1,000 callsCheck whether a TikTok account is live right now, by handle. - Shop store products
shop_products$0.81 per 1,000 callsList the products of one TikTok Shop store from itsshop_idor store link, in a chosen market. - Shop product reviews
shop_product_reviews$0.76 per 1,000 callsRead buyer reviews of one TikTok Shop product from itsproduct_idor product link. - Trending hashtags
trending_hashtags$0.81 per 1,000 callsRead the trending hashtags on TikTok for one market over the last 7, 30 or 90 days, optionally for one industry. - Username to user ID
resolve_user$0.56 per 1,000 callsTurn a TikTokusername(with or without @), a profile link or asec_uidinto the account's numericuser_id, itssec_uid, currentusernameand profileurl. - Link recognition
resolve_links$0.56 per 1,000 callsRead the video ID from one TikTok link inurl, including vm.tiktok.com and vt.tiktok.com share links. - Hashtag detail
hashtag_detail$0.56 per 1,000 callsRead one TikTok hashtag fromhashtag(its name, with or without #, a tag link or the numeric ID):hashtag_id,hashtag_name,url, exactvideo_countandview_count, andis_commercial.