Instagram

Instagram Highlights API

Persistent Story Highlight albums for a public profile — id, title, cover, owner.

Pass a profile URL/@handle or numeric userId and get that account's Story Highlight albums as clean JSON — persistent collections (GRWM, Travel, Products…), not live 24h Stories. Each item always keys id, title, coverUrl, itemCount, and owner{id,username,url} — null when that rung did not expose them, never absent. The native tray is often login-gated; we read highlights from the logged-out profile data first, then the mobile highlights tray. Bare /stories/highlights/ ids from public profile HTML are not returned — those ids do not resolve on /v1/instagram/highlights-details, so an HTML-only shelf is 503 ids_unresolvable (retryable, 0 credits) instead of a billed 200 that leads to 404s. userId skips handle→ID resolve; when only userId is set we reverse-resolve the username so the WPI shelf can still run. A live handle that neighbouring endpoints resolve is never 404: resolver miss is 502 (pass userId from /v1/instagram/basic-profile or /v1/instagram/profile-search), tray miss or unresolvable HTML ids is 503 (0 credits). 404 only when Instagram confirms the account is gone. This list and /v1/instagram/highlights-details are a pair: details needs an id only a full shelf (or Instagram's web UI) can give you. Flat 1 credit on a full shelf. Pass cache=true for the 24h shared cache.

Docs: https://captapi.com/apis/instagram-highlights

get/v1/instagram/highlights

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/instagram/highlights
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring

Instagram profile URL, @handle, or username. Omit when userId is set.

userIdstring

Numeric Instagram user ID. Prefer when known — skips handle→ID resolve. When only userId is set we reverse-resolve the username so the WPI / profile-HTML shelf can still run.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.