GETProfiles2 credits

Get highlights

GET https://api.instagramapi.dev/v1/profile/highlights

Returns the saved story highlights pinned to a profile.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

NameTypeRequiredDescription
handlestringyesAn Instagram account. Accepts a username (`nike`), a numeric user id (`13460080`), or a full profile URL (`https://instagram.com/nike`). We resolve it automatically.

Example request

curl "https://api.instagramapi.dev/v1/profile/highlights?handle=nike" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

Try it

Live request · uses 2 credits

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "items": [
      {
        "id": "highlight:17975319242920589",
        "title": "Just Do It",
        "media_count": 49,
        "created_at": "2025-09-10T18:33:44Z",
        "cover_image_url": "https://instagram.com/.../cover.jpg"
      }
    ],
    "next_cursor": null
  },
  "meta": {
    "endpoint": "profile/highlights",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 2,
    "credits_remaining": 4987,
    "ms": 412
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

FieldTypeDescription
itemsarray<object>The profile's saved story highlights.
items[].idstringHighlight id.
items[].titlestringThe highlight's title.
items[].media_countnumberNumber of stories saved in the highlight.
items[].created_atstringWhen the highlight was created (ISO 8601, UTC).
items[].cover_image_urlstringURL of the highlight's cover image.
next_cursornullAlways null. This endpoint returns a single page and isn't paginated.