KonbiniAPI · Schema
TikTokAudio
Audio or music track
APISocial MediaInstagramTikTokActivityStreams 2.0ScrapingData ExtractionPublic DataInfluencer MarketingSocial ListeningCreator ToolsMCPModel Context Protocol
Properties
| Name | Type | Description |
|---|---|---|
| type | string | ActivityStreams object type |
| id | string | Audio permalink |
| url | string | Audio playback URL |
| name | string | Track name |
| duration | number | Duration in seconds |
| mediaType | string | MIME type |
| attributedTo | object | Audio creator or artist |
| icon | object | |
| image | array | Cover images in multiple sizes |
| entityId | string | Audio ID |
| album | string | Album name |
| isOriginal | boolean | Whether audio is user-created vs a licensed track |
| isCopyrighted | boolean | Whether audio has copyright restrictions |
| videoCount | integer | Number of videos using this audio |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/konbiniapi/main/json-schema/konbiniapi-tik-tok-audio-schema.json",
"title": "TikTokAudio",
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Audio"
},
"id": {
"type": "string",
"format": "uri",
"description": "Audio permalink",
"example": "https://www.tiktok.com/music/original-sound-7611615657754381599"
},
"url": {
"type": "string",
"format": "uri",
"description": "Audio playback URL",
"example": "https://sf16-ies-music.tiktokcdn.com/obj/tos-alisg-v/123456"
},
"name": {
"type": "string",
"description": "Track name",
"example": "original sound"
},
"duration": {
"type": "number",
"description": "Duration in seconds",
"example": 23
},
"mediaType": {
"type": "string",
"description": "MIME type",
"example": "audio/mpeg"
},
"attributedTo": {
"anyOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Person"
},
"id": {
"type": "string",
"format": "uri",
"description": "Profile URL",
"example": "https://www.tiktok.com/@khaby.lame"
},
"url": {
"type": "string",
"format": "uri",
"description": "Profile URL",
"example": "https://www.tiktok.com/@khaby.lame"
},
"entityId": {
"type": "string",
"description": "TikTok secUid",
"example": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA"
},
"name": {
"type": "string",
"description": "Display name",
"example": "Khabane Lame"
},
"preferredUsername": {
"type": "string",
"description": "Username or handle",
"example": "khaby.lame"
},
"summary": {
"type": "string",
"description": "Bio text",
"example": "Just a guy who reacts"
},
"attachment": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Link"
},
"href": {
"type": "string",
"format": "uri",
"description": "Link URL",
"example": "https://linktr.ee/khaby.lame"
},
"rel": {
"type": "string",
"description": "Link relation hint",
"example": "preferred"
}
},
"required": [
"type",
"href"
],
"description": "External link"
},
"description": "External links in bio"
},
"published": {
"type": "string",
"format": "date-time",
"description": "Account creation date in ISO 8601 format",
"example": "2020-03-15T00:00:00.000Z"
},
"isPrivate": {
"type": "boolean",
"description": "Whether account is private",
"example": false
},
"isVerified": {
"type": "boolean",
"description": "Whether account is verified",
"example": true
},
"isLive": {
"type": "boolean",
"description": "Whether user is currently live streaming",
"example": false
},
"hasLikes": {
"type": "boolean",
"description": "Whether user's liked videos are public",
"example": true
},
"hasPlaylists": {
"type": "boolean",
"description": "Whether user has playlists",
"example": true
},
"followerCount": {
"type": "integer",
"description": "Number of followers",
"example": 160300000
},
"followingCount": {
"type": "integer",
"description": "Number of accounts followed",
"example": 85
},
"language": {
"type": "string",
"description": "User language preference (BCP47 code)",
"example": "en"
},
"likeCount": {
"type": "integer",
"description": "Total likes received across all content",
"example": 2600000000
},
"likedCount": {
"type": "integer",
"description": "Number of videos the user has liked",
"example": 5300
},
"mediaCount": {
"type": "integer",
"description": "Number of posts",
"example": 1309
},
"icon": {
"allOf": [
{
"$ref": "#/components/schemas/TikTokImage"
},
{
"description": "Author avatar"
}
]
},
"image": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Image"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL",
"example": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg"
},
"width": {
"type": "integer",
"description": "Width in pixels",
"example": 576
},
"height": {
"type": "integer",
"description": "Height in pixels",
"example": 1024
}
},
"required": [
"type",
"url"
],
"description": "Image resource with optional dimensions"
},
"description": "Profile pictures in multiple sizes"
}
},
"required": [
"type",
"id",
"url",
"isPrivate",
"isVerified"
],
"description": "Compact user profile for embedded contexts"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Person"
},
"id": {
"type": "string",
"format": "uri",
"description": "Profile URL",
"example": "https://www.tiktok.com/@khaby.lame"
},
"url": {
"type": "string",
"format": "uri",
"description": "Profile URL",
"example": "https://www.tiktok.com/@khaby.lame"
},
"entityId": {
"type": "string",
"description": "TikTok secUid",
"example": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA"
},
"name": {
"type": "string",
"description": "Display name",
"example": "Khabane Lame"
},
"preferredUsername": {
"type": "string",
"description": "Username or handle",
"example": "khaby.lame"
},
"summary": {
"type": "string",
"description": "Bio text",
"example": "Just a guy who reacts"
},
"attachment": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TikTokLink"
},
"description": "External links in bio"
},
"published": {
"type": "string",
"format": "date-time",
"description": "Account creation date in ISO 8601 format",
"example": "2020-03-15T00:00:00.000Z"
},
"isPrivate": {
"type": "boolean",
"description": "Whether account is private",
"example": false
},
"isVerified": {
"type": "boolean",
"description": "Whether account is verified",
"example": true
},
"isLive": {
"type": "boolean",
"description": "Whether user is currently live streaming",
"example": false
},
"hasLikes": {
"type": "boolean",
"description": "Whether user's liked videos are public",
"example": true
},
"hasPlaylists": {
"type": "boolean",
"description": "Whether user has playlists",
"example": true
},
"followerCount": {
"type": "integer",
"description": "Number of followers",
"example": 160300000
},
"followingCount": {
"type": "integer",
"description": "Number of accounts followed",
"example": 85
},
"language": {
"type": "string",
"description": "User language preference (BCP47 code)",
"example": "en"
},
"likeCount": {
"type": "integer",
"description": "Total likes received across all content",
"example": 2600000000
},
"likedCount": {
"type": "integer",
"description": "Number of videos the user has liked",
"example": 5300
},
"mediaCount": {
"type": "integer",
"description": "Number of posts",
"example": 1309
},
"icon": {
"allOf": [
{
"$ref": "#/components/schemas/TikTokImage"
},
{
"description": "Author avatar"
}
]
},
"image": {
"type": "array",
"items": {
"$ref": "#/components/schemas/TikTokImage"
},
"description": "Profile pictures in multiple sizes"
}
},
"required": [
"type",
"id",
"url",
"isPrivate",
"isVerified"
],
"description": "Compact user profile for embedded contexts"
}
}
],
"description": "Audio creator or artist"
},
"icon": {
"allOf": [
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Image"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL",
"example": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg"
},
"width": {
"type": "integer",
"description": "Width in pixels",
"example": 576
},
"height": {
"type": "integer",
"description": "Height in pixels",
"example": 1024
}
},
"required": [
"type",
"url"
],
"description": "Image resource with optional dimensions"
},
{
"description": "Thumbnail image"
}
]
},
"image": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Image"
},
"url": {
"type": "string",
"format": "uri",
"description": "Image URL",
"example": "https://p16-sign.tiktokcdn-us.com/tos-maliva-avt-0068/avatar.jpeg"
},
"width": {
"type": "integer",
"description": "Width in pixels",
"example": 576
},
"height": {
"type": "integer",
"description": "Height in pixels",
"example": 1024
}
},
"required": [
"type",
"url"
],
"description": "Image resource with optional dimensions"
},
"description": "Cover images in multiple sizes"
},
"entityId": {
"type": "string",
"description": "Audio ID",
"example": "7493556331997071377"
},
"album": {
"type": "string",
"description": "Album name",
"example": "Greatest Hits"
},
"isOriginal": {
"type": "boolean",
"description": "Whether audio is user-created vs a licensed track",
"example": false
},
"isCopyrighted": {
"type": "boolean",
"description": "Whether audio has copyright restrictions",
"example": false
},
"videoCount": {
"type": "integer",
"description": "Number of videos using this audio",
"example": 500000
}
},
"required": [
"type",
"name",
"duration"
],
"description": "Audio or music track"
}