KonbiniAPI · JSON Structure

Konbiniapi Instagram Post Structure

Instagram post (photo, video, or carousel)

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

InstagramPost is a JSON Structure definition published by KonbiniAPI.

Meta-schema:

JSON Structure

Raw ↑
{
  "name": "InstagramPost",
  "description": "Instagram post (photo, video, or carousel)",
  "as_type": "See ActivityStreams 2.0",
  "required_fields": [
    "entityId",
    "id",
    "type",
    "url"
  ],
  "fields": [
    {
      "name": "type",
      "type": "string",
      "required": true,
      "description": "ActivityStreams object type",
      "example": "Video",
      "format": null
    },
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "Post permalink",
      "example": "https://www.instagram.com/p/CybWViruta1/",
      "format": "uri"
    },
    {
      "name": "url",
      "type": "string",
      "required": true,
      "description": "Post URL",
      "example": "https://www.instagram.com/p/CybWViruta1/",
      "format": "uri"
    },
    {
      "name": "entityId",
      "type": "string",
      "required": true,
      "description": "Post shortcode (used as lookup key)",
      "example": "CybWViruta1",
      "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": false,
      "description": "Publication date in ISO 8601 format",
      "example": "2026-02-27T18:36:42.000Z",
      "format": "date-time"
    },
    {
      "name": "likeCount",
      "type": "integer",
      "required": false,
      "description": "Number of likes",
      "example": 2800000,
      "format": null
    },
    {
      "name": "commentCount",
      "type": "integer",
      "required": false,
      "description": "Number of comments",
      "example": 29200,
      "format": null
    },
    {
      "name": "attributedTo",
      "type": "unknown",
      "required": false,
      "description": "Post author or collaborators",
      "example": null,
      "format": null
    },
    {
      "name": "location",
      "type": "$ref:InstagramLocation",
      "required": false,
      "description": "Post location tag",
      "example": null,
      "format": null
    },
    {
      "name": "tag",
      "type": "array<InstagramTag>",
      "required": false,
      "description": "Tagged users or hashtags",
      "example": null,
      "format": null
    },
    {
      "name": "language",
      "type": "string",
      "required": false,
      "description": "Content language (BCP47 code)",
      "example": "en",
      "format": null
    },
    {
      "name": "isEdited",
      "type": "boolean",
      "required": false,
      "description": "Whether the caption has been edited",
      "example": false,
      "format": null
    },
    {
      "name": "isSponsored",
      "type": "boolean",
      "required": false,
      "description": "Whether post is a paid partnership",
      "example": false,
      "format": null
    },
    {
      "name": "viewCount",
      "type": "integer",
      "required": false,
      "description": "Number of views",
      "example": 42600000,
      "format": null
    },
    {
      "name": "duration",
      "type": "number",
      "required": false,
      "description": "Duration in seconds",
      "example": 23,
      "format": null
    },
    {
      "name": "contentFormat",
      "type": "string",
      "required": false,
      "description": "Content format (e.g. photo, video, carousel)",
      "example": "reel",
      "format": null
    },
    {
      "name": "attachment",
      "type": "array<InstagramAttachment>",
      "required": false,
      "description": "Media files",
      "example": null,
      "format": null
    },
    {
      "name": "image",
      "type": "$ref:InstagramImageWithDimensions",
      "required": false,
      "description": "Post cover image",
      "example": null,
      "format": null
    },
    {
      "name": "audio",
      "type": "$ref:InstagramAudio",
      "required": false,
      "description": "Post audio track",
      "example": null,
      "format": null
    },
    {
      "name": "name",
      "type": "string",
      "required": false,
      "description": "Alt text or accessibility caption",
      "example": "Photo of Khabane Lame",
      "format": null
    },
    {
      "name": "totalItems",
      "type": "integer",
      "required": false,
      "description": "Number of carousel items",
      "example": 5,
      "format": null
    },
    {
      "name": "items",
      "type": "array<InstagramCarouselItem>",
      "required": false,
      "description": "Carousel slides",
      "example": null,
      "format": null
    }
  ]
}