UnifAPI Docs

Get an Instagram story highlight

Returns one Instagram story highlight by id with its title, cover and story items. Returns `not_found` when the highlight does not exist.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/instagram/highlights/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

id*string

Numeric highlight id, as in instagram.com/stories/highlights/{id}.

Length1 <= length <= 500

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/instagram/highlights/string"
{  "request_id": "string",  "data": {    "id": "string",    "title": "string",    "cover_url": "string",    "media_count": 0,    "created_at": 0,    "updated_at": 0,    "media": [      {        "id": "string",        "shortcode": "string",        "url": "string",        "kind": "string",        "media_type": "string",        "caption": "string",        "alt_text": "string",        "created_at": 0,        "owner": {          "id": "string",          "username": "string",          "display_name": "string",          "avatar_url": "string",          "is_verified": true,          "is_private": true        },        "like_count": 0,        "comment_count": 0,        "play_count": 0,        "share_count": 0,        "save_count": 0,        "is_likes_hidden": true,        "image_url": "string",        "thumbnail_url": "string",        "video_url": "string",        "duration": 0,        "dimensions": {          "width": 0,          "height": 0        },        "carousel": [          {            "id": "string",            "media_type": "string",            "image_url": "string",            "video_url": "string",            "duration": 0,            "dimensions": {              "width": 0,              "height": 0            },            "alt_text": "string"          }        ],        "audio": {          "id": "string",          "title": "string",          "artist": "string",          "is_original": true,          "artist_handle": "string"        },        "coauthors": [          {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "string",            "is_verified": true,            "is_private": true          }        ],        "tagged_users": [          {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "string",            "is_verified": true,            "is_private": true          }        ],        "location": {          "id": "string",          "name": "string",          "lat": 0,          "lng": 0        },        "is_paid_partnership": true,        "sponsors": [          {            "id": "string",            "username": "string",            "display_name": "string",            "avatar_url": "string",            "is_verified": true,            "is_private": true          }        ],        "is_comments_disabled": true,        "is_pinned": true,        "story": {          "expires_at": 0,          "link_stickers": [            {              "url": "string",              "display_url": "string"            }          ],          "mentions": [            {              "id": "string",              "username": "string",              "display_name": "string",              "avatar_url": "string",              "is_verified": true,              "is_private": true            }          ],          "shared_media": {            "id": "string",            "shortcode": "string"          }        }      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}