Instagram data API

Instagram Highlights API

Highlights keep stories visible on a profile for as long as the owner likes. List a profile's highlight albums, then fetch every photo and video inside any of them from a highlight link or id.

Request

GET /v1/profiles/{username}/highlights · 3 credits per successful call

cURL
curl "https://api.igramapi.com/v1/profiles/example_creator/highlights" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK · application/json
{
  "username": "example_creator",
  "count": 2,
  "albums": [
    {
      "highlight_id": "17926428858101042",
      "title": "Travel",
      "cover_image_url": "https://scontent.cdninstagram.com/v/example/cover1.jpg",
      "media_count": 24
    },
    {
      "highlight_id": "17987654321098765",
      "title": "Behind the scenes",
      "cover_image_url": "https://scontent.cdninstagram.com/v/example/cover2.jpg",
      "media_count": 11
    }
  ],
  "cached": false
}

All values above are made-up examples. Media links are temporary Instagram CDN addresses.

Parameters

NameInDescription
usernamerequired path Instagram username.
url / id query On GET /v1/highlights: a highlight URL, share link or numeric id.

Response fields

FieldTypeDescription
albums[].highlight_idstringId to use with /v1/highlights.
albums[].titlestring | nullAlbum name.
albums[].cover_image_urlstring | nullCover picture.
albums[].media_countintegerItems in the album.
items[] (highlight media)object[]story_id, type, media_url, thumbnail, duration, taken_at.

Two steps, two calls

List albums with /v1/profiles/{username}/highlights, then fetch media with /v1/highlights?id=.

Any link format

Highlight URLs, mobile share links and bare ids are all understood.

Durable content

Unlike stories, highlights stay up, which makes them ideal to archive or analyze.

Paid plans

Each call uses 3 credits and is available on every paid plan.

Fetching the media of a highlight

Take a highlight_id from the album list and call GET /v1/highlights?id={highlight_id}. The response lists each item with its type, media link, thumbnail and timestamps in the same shape as the Stories API.

You can also pass a copied highlight link with the url parameter, so you do not need the username at all.

Good fits

Highlights are where creators keep product reviews, FAQs and campaign recaps. Agencies use the endpoint to audit them, and archival tools use it to preserve them.

Frequently asked questions

How do I get the media inside a highlight?

Call GET /v1/highlights with the `id` or `url` of the highlight. The album list gives you each id.

Are highlights of private accounts available?

No. Only public accounts are supported.

Is there a limit on items per highlight?

You receive every item Instagram makes available for that highlight in one response.

Which plans include it?

All paid plans. The free plan covers the standard endpoints only.

Errors cost nothing. Any response with a status of 400 or above is refunded, and every error has the same shape. See error handling and credits and rate limits.

Try the Highlights API free

Create a key and make your first request in minutes. 100 free credits every month.