Instagram Post & Reel Search (by Keyword)

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "examples": [
        "cat"
      ],
      "description": "Search keyword"
    },
    "pagination_token": {
      "type": "string",
      "description": "Pagination token"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "count": {
          "type": "number",
          "description": "Number of items in this page of results."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The post's internal Instagram media ID."
              },
              "code": {
                "type": "string",
                "description": "The post's shortcode, as used in an instagram.com/p/ or /reel/ URL."
              },
              "user": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The account's numeric Instagram user ID."
                  },
                  "username": {
                    "type": "string"
                  },
                  "full_name": {
                    "type": "string"
                  },
                  "is_private": {
                    "type": "boolean"
                  },
                  "is_verified": {
                    "type": "boolean"
                  },
                  "follower_count": {
                    "type": "number"
                  }
                },
                "description": "The public account that posted this item.",
                "additionalProperties": true
              },
              "caption": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string"
                  },
                  "hashtags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": true
              },
              "is_video": {
                "type": "boolean"
              },
              "taken_at": {
                "type": "number",
                "description": "Unix seconds."
              },
              "video_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Playable video URL, withheld the same way as `thumbnail_url`. Present (as `null`, the value withheld) on video/reel items. This field is absent rather than `null` on a photo/feed post."
              },
              "like_count": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "`null` on some items."
              },
              "media_type": {
                "type": "number",
                "description": "Instagram's internal media-type enum, e.g. 2 for video/reel."
              },
              "play_count": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Observed `null` on at least one item."
              },
              "view_count": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Usually `null` on every item -- treat as effectively always null on this endpoint."
              },
              "share_count": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Observed `null` on at least one item."
              },
              "product_type": {
                "type": "string",
                "description": "e.g. 'clips' for a video/reel or 'feed' for a photo post. Results mix media types: most items are typically 'clips', with occasional 'feed' (photo) items."
              },
              "repost_count": {
                "type": "number"
              },
              "comment_count": {
                "type": "number"
              },
              "taken_at_date": {
                "type": "string",
                "description": "ISO 8601."
              },
              "thumbnail_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Cover-image URL. Value withheld (returned as `null`) -- only whether a thumbnail exists is observable, not the image itself."
              },
              "original_width": {
                "type": "number"
              },
              "video_duration": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Seconds. `null` on at least one item observed."
              },
              "original_height": {
                "type": "number"
              }
            },
            "additionalProperties": true
          }
        }
      },
      "additionalProperties": true
    },
    "pagination_token": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pass back into `pagination_token` on the next call to fetch the next page. `null` on the last/only page."
    }
  },
  "description": "The search result document. Typically a populated `data.items` array (e.g. 8 or 5 entries) -- the shape of a genuinely empty search result is not documented.",
  "additionalProperties": true
}