KonbiniAPI · JSON Structure

Konbiniapi Tik Tok Story Structure

Story post

Type: Properties: 0
APISocial MediaInstagramTikTokActivityStreams 2.0ScrapingData ExtractionPublic DataInfluencer MarketingSocial ListeningCreator ToolsMCPModel Context Protocol

TikTokStory is a JSON Structure definition published by KonbiniAPI.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "TikTokStory",
  "description": "Story 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": "Story permalink",
      "example": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000",
      "format": "uri"
    },
    {
      "name": "url",
      "type": "string",
      "required": true,
      "description": "Story URL",
      "example": "https://www.tiktok.com/@khaby.lame/video/7600000000000000000",
      "format": "uri"
    },
    {
      "name": "entityId",
      "type": "string",
      "required": true,
      "description": "TikTok internal story ID",
      "example": "7600000000000000000",
      "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": "endTime",
      "type": "string",
      "required": false,
      "description": "Story expiration date in ISO 8601 format",
      "example": "2026-02-28T18:36:42.000Z",
      "format": "date-time"
    },
    {
      "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": "attributedTo",
      "type": "unknown",
      "required": true,
      "description": null,
      "example": null,
      "format": null
    },
    {
      "name": "duration",
      "type": "number",
      "required": false,
      "description": "Duration in seconds",
      "example": 23,
      "format": null
    },
    {
      "name": "attachment",
      "type": "array<TikTokStoryAttachment>",
      "required": false,
      "description": "Video files",
      "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": "unknown",
      "required": false,
      "description": null,
      "example": null,
      "format": null
    }
  ]
}