Skip to content
Eden Engine

Instagram Highlight Reels Lookup (by Username or User ID)

omnial/instagram-fetch-user-highlights

Given an Instagram username or numeric user ID, returns that account's saved story highlight reels: each reel's title, media count, pin/archive/conversion flags, cover image dimensions, and the account's own public profile summary (display name, handle, verification and privacy status). Confirmed against two real accounts: a public brand profile with 7 highlight reels and an individual public profile with 1.

activeper callv1
Provider
Web & Business Data Network
Category
instagram
Provider price
$0.004095 per call
Latency p50 / p95
— / —
Success rate
—
Verified
—

Provider list price; Omnial MCP charges provider cost plus a platform markup on top.

Contract

input_schema.json
{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "user_id"
      ]
    },
    {
      "required": [
        "username"
      ]
    }
  ],
  "properties": {
    "user_id": {
      "type": "string",
      "examples": [
        "18527"
      ],
      "description": "Numeric Instagram user ID to look up highlights for."
    },
    "username": {
      "type": "string",
      "examples": [
        "instagram"
      ],
      "description": "Instagram username (handle) to look up highlights for."
    }
  },
  "additionalProperties": false
}
output_schema.json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "count": {
          "type": "number",
          "description": "Number of highlight reels returned."
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "description": "The highlight reel's own id, e.g. 'highlight:18029499352961095'."
              },
              "user": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "The account's numeric Instagram user id."
                  },
                  "username": {
                    "type": "string",
                    "description": "The account's own public handle."
                  },
                  "full_name": {
                    "type": "string",
                    "description": "The account's own public display name."
                  },
                  "is_private": {
                    "type": "boolean"
                  },
                  "is_verified": {
                    "type": "boolean"
                  },
                  "account_badges": {
                    "type": "array",
                    "items": {},
                    "description": "Empty on both real accounts observed; item shape unconfirmed."
                  },
                  "profile_pic_url": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Value withheld (stripped to `null`) in this tool's output."
                  },
                  "fifa_country_code": {
                    "type": "string"
                  }
                },
                "description": "The queried account's own public profile summary.",
                "additionalProperties": true
              },
              "title": {
                "type": "string"
              },
              "can_reply": {
                "type": "boolean",
                "description": "Whether viewers can reply to this highlight."
              },
              "reel_type": {
                "type": "string",
                "description": "'highlight_reel' on both fixtures observed."
              },
              "created_at": {
                "type": "number",
                "description": "Unix seconds."
              },
              "can_reshare": {
                "type": "boolean"
              },
              "cover_media": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Observed as the literal string 'None' on several items and as a real numeric-string media id on others -- not a stable identifier to rely on."
                  },
                  "crop_rect": {
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "number"
                    },
                    "description": "Four-number crop rectangle (fractional coordinates) when the cover was manually cropped, `null` otherwise -- both shapes observed across the two fixtures."
                  },
                  "upload_id": {
                    "type": [
                      "string",
                      "number",
                      "null"
                    ],
                    "description": "Always observed `null` on both real fixtures calibrated."
                  },
                  "full_image_version": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Value withheld (stripped to `null`) in this tool's output."
                      },
                      "width": {
                        "type": "number"
                      },
                      "height": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  "cropped_image_version": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "description": "Value withheld (stripped to `null`) in this tool's output."
                      },
                      "width": {
                        "type": "number"
                      },
                      "height": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "description": "The reel's cover image.",
                "additionalProperties": true
              },
              "is_archived": {
                "type": "boolean"
              },
              "media_count": {
                "type": "number",
                "description": "Number of stories inside this reel."
              },
              "latest_reel_media": {
                "type": "number",
                "description": "Id of the most recently added story media in this reel."
              },
              "updated_timestamp": {
                "type": "number",
                "description": "Unix seconds."
              },
              "highlight_reel_type": {
                "type": "string",
                "description": "'DEFAULT' on both fixtures observed."
              },
              "is_pinned_highlight": {
                "type": "boolean"
              },
              "is_converted_to_clips": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "description": "One entry per saved highlight reel."
        }
      },
      "additionalProperties": true
    },
    "pagination_token": {
      "type": [
        "string",
        "null"
      ],
      "description": "Cursor for a further page of highlights. `null` on both fixtures observed (no more pages)."
    }
  },
  "description": "The highlights record, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}

Pricing

Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.

Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.

ChargeRate
Per call
Flat, regardless of what comes back
$0.004095
Cost basis
Not recorded

This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.

Updated
Sep 23, 2026