instagram_post

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/scrapefield-com/json-schema/scrapefield-com-instagram-post-schema.json",
  "title": "instagram_post",
  "description": "An Instagram post or Reel.",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/scrapefield-com-openapi.json#/components/schemas/instagram_post",
  "type": "object",
  "required": [
    "id",
    "shortcode",
    "permalink",
    "media_type",
    "media_product_type",
    "caption",
    "timestamp",
    "username",
    "media_url",
    "thumbnail_url",
    "children",
    "video_duration",
    "like_count",
    "comments_count",
    "view_count",
    "hashtags",
    "mentions",
    "location",
    "is_paid_partnership"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Instagram's numeric id for the post."
    },
    "shortcode": {
      "type": "string",
      "description": "The code in the URL, e.g. `C1a2B3c4D5e`."
    },
    "permalink": {
      "type": "string",
      "format": "uri",
      "description": "The post."
    },
    "media_type": {
      "type": "string",
      "enum": [
        "IMAGE",
        "VIDEO",
        "CAROUSEL_ALBUM"
      ],
      "description": "As the Graph API names them."
    },
    "media_product_type": {
      "type": "string",
      "enum": [
        "FEED",
        "REELS"
      ],
      "description": "A grid post or a Reel."
    },
    "caption": {
      "type": [
        "string",
        "null"
      ],
      "description": "The caption."
    },
    "timestamp": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "When it was posted. `null` when the source does not say."
    },
    "username": {
      "type": "string",
      "description": "Who posted it."
    },
    "media_url": {
      "type": "string",
      "format": "uri",
      "description": "The image, or the video file. A carousel's first item. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media."
    },
    "thumbnail_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri",
      "description": "The cover of a video. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media."
    },
    "children": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "media_type",
          "media_url"
        ],
        "properties": {
          "media_type": {
            "type": "string",
            "enum": [
              "IMAGE",
              "VIDEO"
            ],
            "description": "An image or a video."
          },
          "media_url": {
            "type": "string",
            "format": "uri",
            "description": "The image, or the video file. On Instagram's CDN. Instagram signs the link, and it stops working within a few days, so fetch the file soon. We do not rehost media."
          }
        },
        "additionalProperties": false
      },
      "description": "A carousel's items, in order. Empty for a single image or video."
    },
    "video_duration": {
      "type": [
        "number",
        "null"
      ],
      "description": "Seconds."
    },
    "like_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "`null` when the owner has hidden it."
    },
    "comments_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "`null` when the source does not give it."
    },
    "view_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "Views, for videos and Reels."
    },
    "hashtags": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One hashtag."
      },
      "description": "The caption's hashtags, without the #."
    },
    "mentions": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One username."
      },
      "description": "The usernames the caption mentions, without the @."
    },
    "location": {
      "type": [
        "object",
        "null"
      ],
      "required": [
        "id",
        "name"
      ],
      "properties": {
        "id": {
          "type": "string",
          "description": "Instagram's id for the location."
        },
        "name": {
          "type": "string",
          "description": "The place's name, as the tag shows it."
        }
      },
      "additionalProperties": false,
      "description": "The location tag."
    },
    "is_paid_partnership": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether it carries the \"Paid partnership\" label. `null` where that is not known."
    }
  },
  "additionalProperties": false
}