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 TikHub has no music-recognition match for the id (see verification.notes) 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 the not-found-style fixture (no matched artist); one entry on the well-known-track fixture."
},
"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 the well-known-track fixture -- absent (not an empty array) on the not-found-style fixture, 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 TikHub's music-recognition matched this sound to a catalogued commercial song; absent entirely otherwise (observed absent on the not-found-style fixture).",
"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": "Observed empty-string on the not-found-style fixture -- 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 the well-known-track fixture -- absent entirely (not merely empty) on the not-found-style fixture.",
"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 TikHub has matched them; absent entirely on the not-found-style fixture (observed null upstream there and dropped by the allowlist rather than shaped to null)."
},
"commercial_right_type": {
"type": "number",
"description": "Vendor-internal enum; TikHub does not document the mapping. Observed values 1 (the not-found-style fixture) and 3 (the well-known-track fixture)."
},
"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 on the not-found-style fixture (observed null upstream there and dropped by the allowlist rather than shaped to null); the actual play URL for each tier is never shipped (see this file's header)."
}
},
"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, as returned at routing.responseResultPath ($.output).",
"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
- Sep 8, 2026