KonbiniAPI · JSON Structure
Konbiniapi Tik Tok Video Structure
Video post
Type:
Properties: 0
APISocial MediaInstagramTikTokActivityStreams 2.0ScrapingData ExtractionPublic DataInfluencer MarketingSocial ListeningCreator ToolsMCPModel Context Protocol
TikTokVideo is a JSON Structure definition published by KonbiniAPI.
Meta-schema:
JSON Structure
{
"name": "TikTokVideo",
"description": "Video post",
"as_type": "See ActivityStreams 2.0",
"required_fields": [
"attributedTo",
"commentCount",
"entityId",
"id",
"likeCount",
"published",
"repostCount",
"saveCount",
"shareCount",
"type",
"url",
"viewCount"
],
"fields": [
{
"name": "type",
"type": "string",
"required": true,
"description": "ActivityStreams object type",
"example": "Video",
"format": null
},
{
"name": "id",
"type": "string",
"required": true,
"description": "Video permalink",
"example": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
"format": "uri"
},
{
"name": "url",
"type": "string",
"required": true,
"description": "Video URL",
"example": "https://www.tiktok.com/@khaby.lame/video/7611615657754381599",
"format": "uri"
},
{
"name": "entityId",
"type": "string",
"required": true,
"description": "TikTok internal video ID",
"example": "7611615657754381599",
"format": null
},
{
"name": "content",
"type": "string",
"required": false,
"description": "Caption or description",
"example": "When you realize there is a simpler way #learnfromkhaby",
"format": null
},
{
"name": "published",
"type": "string",
"required": true,
"description": "Publication date in ISO 8601 format",
"example": "2026-02-27T18:36:42.000Z",
"format": "date-time"
},
{
"name": "duration",
"type": "number",
"required": false,
"description": "Duration in seconds",
"example": 23,
"format": null
},
{
"name": "viewCount",
"type": "integer",
"required": true,
"description": "Number of views",
"example": 42600000,
"format": null
},
{
"name": "likeCount",
"type": "integer",
"required": true,
"description": "Number of likes",
"example": 2800000,
"format": null
},
{
"name": "commentCount",
"type": "integer",
"required": true,
"description": "Number of comments",
"example": 29200,
"format": null
},
{
"name": "repostCount",
"type": "integer",
"required": true,
"description": "Number of reposts",
"example": 0,
"format": null
},
{
"name": "shareCount",
"type": "integer",
"required": true,
"description": "Number of shares",
"example": 157700,
"format": null
},
{
"name": "saveCount",
"type": "integer",
"required": true,
"description": "Number of saves",
"example": 153238,
"format": null
},
{
"name": "language",
"type": "string",
"required": false,
"description": "Content language (BCP47 code)",
"example": "en",
"format": null
},
{
"name": "isSponsored",
"type": "boolean",
"required": false,
"description": "Whether the video is a promoted ad",
"example": false,
"format": null
},
{
"name": "location",
"type": "object",
"required": false,
"description": "Location where the video was created",
"example": {
"type": "Place",
"name": "US"
},
"format": null
},
{
"name": "tag",
"type": "array<TikTokTag>",
"required": false,
"description": "Hashtags and mentions",
"example": null,
"format": null
},
{
"name": "attributedTo",
"type": "$ref:TikTokEmbeddedUser",
"required": true,
"description": "Video creator",
"example": null,
"format": null
},
{
"name": "attachment",
"type": "array<TikTokVideoAttachment>",
"required": false,
"description": "Video files in multiple qualities",
"example": null,
"format": null
},
{
"name": "image",
"type": "unknown",
"required": false,
"description": null,
"example": null,
"format": null
},
{
"name": "preview",
"type": "unknown",
"required": false,
"description": null,
"example": null,
"format": null
},
{
"name": "audio",
"type": "$ref:TikTokAudio",
"required": false,
"description": "Video audio track",
"example": null,
"format": null
}
]
}