Instagram API: List profile highlights (v1)

List an account's story highlights, by username or user_id. Paginate with cursor and next_cursor. An account without highlights returns an empty items list.

3 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

username?string

Account username with or without @, or an instagram.com profile URL.

Lengthlength <= 300

user_id?string

Numeric account ID, from the pk field of /v1/instagram/profile. Send exactly one of username or user_id.

Match^\d{1,25}$

cursor?string

next_cursor from the previous response. Omit for the first page and send it unchanged for later pages.

Lengthlength <= 2000

curl -X GET "https://example.com/v1/instagram/profile/highlights" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "items": [      {        "property1": null,        "property2": null      }    ],    "next_cursor": "string"  },  "details": {    "reason": "string",    "message": "string"  }}