Contract
input_schema.json
{
"type": "object",
"required": [
"music_id"
],
"properties": {
"music_id": {
"type": "string",
"examples": [
"6943027371519772674"
],
"description": "Music id"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"required": [
"behind_the_song_exist",
"music_info"
],
"properties": {
"music_info": {
"type": "object",
"required": [
"id_str",
"title",
"author",
"album",
"duration",
"audition_duration",
"create_time",
"is_original",
"is_original_sound",
"is_commerce_music",
"has_commerce_right",
"commercial_right_type",
"author_deleted",
"prevent_download",
"preview_start_time",
"preview_end_time",
"can_be_stitched",
"can_not_reuse",
"offline_desc",
"user_count",
"is_pgc",
"is_shooting_allow",
"is_author_artist",
"artists",
"suggest_words",
"share_info"
],
"properties": {
"album": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": "string",
"description": "Credited composer/performer name (e.g. 'C418'). Observed as the literal string 'Unknown' when the upstream service has no music-recognition match for the id rather than an empty string or null."
},
"id_str": {
"type": "string",
"description": "Stable string music id (matches the input)."
},
"is_pgc": {
"type": "boolean",
"description": "'Professionally generated content' -- true for a commercially released track rather than user-generated audio."
},
"artists": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "Opaque platform account id."
},
"handle": {
"type": "string",
"description": "Public TikTok handle for the artist."
},
"sec_uid": {
"type": "string",
"description": "Opaque platform account id."
},
"nick_name": {
"type": "string",
"description": "Public display name for the artist."
},
"is_verified": {
"type": "boolean"
}
},
"additionalProperties": true
},
"description": "The credited artist account(s) for the track. Empty array on a not-found-style lookup (no matched artist); one entry on a well-known track."
},
"duration": {
"type": "number",
"description": "Full track duration, in seconds."
},
"share_info": {
"type": "object",
"properties": {
"share_desc": {
"type": "string"
},
"share_title": {
"type": "string"
},
"share_desc_info": {
"type": "string"
}
},
"additionalProperties": true
},
"theme_tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Genre/theme labels (e.g. 'SoundTrack', 'Game'). Observed only on a well-known track -- absent (not an empty array) on a not-found-style lookup, so treat as optional."
},
"user_count": {
"type": "number",
"description": "Number of videos/creators using this sound, as reported by TikTok."
},
"create_time": {
"type": "number",
"description": "Unix seconds -- when this sound was added to TikTok's catalog."
},
"is_original": {
"type": "boolean"
},
"matched_song": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"chorus_info": {
"type": "object",
"properties": {
"start_ms": {
"type": "number"
},
"duration_ms": {
"type": "number"
}
},
"additionalProperties": true
},
"full_duration": {
"type": "number",
"description": "Milliseconds."
}
},
"description": "Present only when the source's music-recognition matched this sound to a catalogued commercial song; absent entirely otherwise (e.g. on a not-found-style lookup).",
"additionalProperties": true
},
"offline_desc": {
"type": "string",
"description": "A regional-licensing-restriction explanation when non-empty (e.g. \"The copyright owner hasn't made this sound available in your country\"); empty string when no such restriction applies."
},
"can_not_reuse": {
"type": "boolean"
},
"suggest_words": {
"type": "object",
"properties": {
"suggest_words": {
"type": "array",
"items": {
"type": "object",
"properties": {
"scene": {
"type": "string"
},
"words": {
"type": "array",
"items": {
"type": "object",
"properties": {
"word": {
"type": "string",
"description": "Can be an empty string (e.g. on a not-found-style lookup) -- not always populated."
},
"word_id": {
"type": "string"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"author_deleted": {
"type": "boolean",
"description": "True when the credited author's account has been deleted."
},
"can_be_stitched": {
"type": "boolean",
"description": "Whether creators can stitch a new video using this sound."
},
"is_author_artist": {
"type": "boolean",
"description": "Whether the credited author is a recognized platform artist account."
},
"prevent_download": {
"type": "boolean"
},
"preview_end_time": {
"type": "number",
"description": "Seconds into the track."
},
"audition_duration": {
"type": "number",
"description": "Preview/audition clip duration, in seconds."
},
"is_commerce_music": {
"type": "boolean",
"description": "True when this is a licensed commercial track."
},
"is_original_sound": {
"type": "boolean",
"description": "True for a sound originally recorded/uploaded on TikTok rather than a commercial track."
},
"is_shooting_allow": {
"type": "boolean",
"description": "Whether new videos can currently be recorded with this sound."
},
"has_commerce_right": {
"type": "boolean"
},
"music_release_info": {
"type": "object",
"properties": {
"group_release_date": {
"type": "number",
"description": "Unix seconds."
},
"is_new_release_song": {
"type": "boolean"
}
},
"description": "Release metadata. Observed only on a well-known track -- absent entirely (not merely empty) on a not-found-style lookup.",
"additionalProperties": true
},
"preview_start_time": {
"type": "number",
"description": "Seconds into the track."
},
"tt_to_dsp_song_infos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"song_id": {
"type": "string",
"description": "The song's id on that external DSP."
},
"platform": {
"type": "number",
"description": "Vendor-internal enum identifying the external DSP; undocumented."
},
"button_type": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Cross-platform song references (Apple Music, Spotify, Deezer, etc.) when the source has matched them; absent entirely (not null) when there is no match, e.g. on a not-found-style lookup."
},
"commercial_right_type": {
"type": "number",
"description": "Source-internal enum; the source does not document the mapping. Observed values 1 (a not-found-style lookup) and 3 (a well-known track)."
},
"multi_bit_rate_play_info": {
"type": "array",
"items": {
"type": "object",
"properties": {
"bit_rate": {
"type": "number"
},
"gear_name": {
"type": "string",
"description": "e.g. 'higher', 'medium', 'highest'."
},
"quality_type": {
"type": "number",
"description": "Vendor-internal enum; undocumented."
}
},
"additionalProperties": true
},
"description": "Available audio quality tiers. Absent entirely (not null) on a not-found-style lookup; the actual play URL for each tier is never returned."
}
},
"description": "The sound's own metadata.",
"additionalProperties": true
},
"behind_the_song_exist": {
"type": "boolean",
"description": "Whether TikTok has a 'behind the song' detail page for this sound."
}
},
"description": "The music/sound record.",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Oct 12, 2026