Get highlight stories

Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.

What it does

Returns all story items within a highlight reel, including images and videos. The highlight ID comes from the highlights list endpoint.

Tool details

Field	Value
Tool name	instagram_get_highlight_stories
Platform	Instagram
REST endpoint	GET /v1/instagram/highlights/{highlightId}
Result type	Collection tool

Parameters

Parameter	Type	Required	Description
highlightId	string	Yes	Instagram highlight ID
projection_preset	string	No	Defaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fields	string[]	No	Adds top-level keys from data on top of the selected projection_preset.
item_fields	string[]	No	Adds keys from data.orderedItems[] on top of the selected projection_preset.

Example

{
  "name": "instagram_get_highlight_stories",
  "arguments": {
    "highlightId": "18067016518767507",
    "projection_preset": "minimal",
    "data_fields": [
      "orderedItems",
      "totalItems",
      "entityId",
      "name"
    ],
    "item_fields": [
      "entityId",
      "published",
      "summary",
      "url",
      "attachment"
    ]
  }
}

Available data fields

• @context
• type
• id
• entityId
• name
• image
• totalItems
• orderedItems

Available item fields

• type
• url
• entityId
• published
• summary
• isSponsored
• image
• attachment
• duration
• attributedTo

Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.