KonbiniAPI · Schema
TikTokStory
Story post
APISocial MediaInstagramTikTokActivityStreams 2.0ScrapingData ExtractionPublic DataInfluencer MarketingSocial ListeningCreator ToolsMCPModel Context Protocol
Properties
| Name | Type | Description |
|---|---|---|
| type | string | ActivityStreams object type |
| id | string | Story permalink |
| url | string | Story URL |
| entityId | string | TikTok internal story ID |
| content | string | Caption or description |
| published | string | Publication date in ISO 8601 format |
| endTime | string | Story expiration date in ISO 8601 format |
| viewCount | integer | Number of views |
| likeCount | integer | Number of likes |
| commentCount | integer | Number of comments |
| repostCount | integer | Number of reposts |
| shareCount | integer | Number of shares |
| saveCount | integer | Number of saves |
| attributedTo | object | |
| duration | number | Duration in seconds |
| attachment | array | Video files |
| image | object | |
| preview | object | |
| audio | object |
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-story-schema.json",
"title": "TikTokStory",
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Video"
},
"id": {
"type": "string",
"format": "uri",
"description": "Story permalink",
"example": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000"
},
"url": {
"type": "string",
"format": "uri",
"description": "Story URL",
"example": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000"
},
"entityId": {
"type": "string",
"description": "TikTok internal story ID",
"example": "7600000000000000000"
},
"content": {
"type": "string",
"description": "Caption or description",
"example": "When you realize there is a simpler way #learnfromkhaby"
},
"published": {
"type": "string",
"format": "date-time",
"description": "Publication date in ISO 8601 format",
"example": "2026-02-27T18:36:42.000Z"
},
"endTime": {
"type": "string",
"format": "date-time",
"description": "Story expiration date in ISO 8601 format",
"example": "2026-02-28T18:36:42.000Z"
},
"viewCount": {
"type": "integer",
"description": "Number of views",
"example": 42600000
},
"likeCount": {
"type": "integer",
"description": "Number of likes",
"example": 2800000
},
"commentCount": {
"type": "integer",
"description": "Number of comments",
"example": 29200
},
"repostCount": {
"type": "integer",
"description": "Number of reposts",
"example": 0
},
"shareCount": {
"type": "integer",
"description": "Number of shares",
"example": 157700
},
"saveCount": {
"type": "integer",
"description": "Number of saves",
"example": 153238
},
"attributedTo": {
"allOf": [
{
"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"
},
{
"description": "Story author"
}
]
},
"duration": {
"type": "number",
"description": "Duration in seconds",
"example": 23
},
"attachment": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "ActivityStreams object type",
"example": "Video"
},
"url": {
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"description": "Media download URLs",
"example": [
"https://v19-webapp.tiktok.com/video/tos/us/tos-useast5-ve-0068c004/story.mp4"
]
},
"mediaType": {
"type": "string",
"description": "MIME type",
"example": "video/mp4"
},
"width": {
"type": "integer",
"description": "Width in pixels",
"example": 576
},
"height": {
"type": "integer",
"description": "Height in pixels",
"example": 1024
},
"name": {
"type": "string",
"description": "Quality label",
"example": "normal_540_0"
},
"headers": {
"allOf": [
{
"type": "object",
"properties": {
"Cookie": {
"type": "string",
"description": "Required cookie header for video download",
"example": "tt_chain_token=sTA6PK6OnvhW7YemGVwMig=="
},
"Referer": {
"type": "string",
"description": "Required referer header for video download",
"example": "https://www.tiktok.com/"
}
},
"required": [
"Cookie",
"Referer"
],
"description": "HTTP headers required for authenticated media download"
},
{
"description": "Authentication headers for story download"
}
]
},
"codec": {
"type": "string",
"description": "Video codec",
"example": "h264"
},
"bitrate": {
"type": "integer",
"description": "Bitrate in bits per second",
"example": 1101943
}
},
"required": [
"type",
"url"
],
"description": "Story media file"
},
"description": "Video files"
},
"image": {
"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": "Story thumbnail"
}
]
},
"preview": {
"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": "Animated preview thumbnail"
}
]
},
"audio": {
"allOf": [
{
"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": [
{
"$ref": "#/components/schemas/TikTokEmbeddedUser"
},
{
"type": "array",
"items": {
"$ref": "#/components/schemas/TikTokEmbeddedUser"
}
}
],
"description": "Audio creator or artist"
},
"icon": {
"allOf": [
{
"$ref": "#/components/schemas/TikTokImage"
},
{
"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"
},
{
"description": "Story audio track"
}
]
}
},
"required": [
"type",
"id",
"url",
"entityId",
"published",
"viewCount",
"likeCount",
"commentCount",
"repostCount",
"shareCount",
"saveCount",
"attributedTo"
],
"description": "Story post"
}