List Instagram stories and highlights | Instagram API

Returns story availability, live status, and highlight metadata for a public Instagram account. Requires user_id; the include_* flags turn extra response sections on or off.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

user_id*string

Numeric Instagram user ID, from the id field of Get User ID or Get User Info.

Length1 <= length

username_or_url?string

Instagram username (without @) or full profile URL, for example natgeo or https://www.instagram.com/natgeo/.

Length3 <= length

include_chaining?boolean

Include related-account chaining data in the response.

Defaultfalse

include_reel?boolean

Include the account's current story reel.

Defaulttrue

include_suggested_users?boolean

Include suggested accounts.

Defaultfalse

include_logged_out_extras?boolean

Include extra fields exposed to logged-out viewers.

Defaulttrue

include_live_status?boolean

Include whether the account is live now.

Defaultfalse

include_highlight_reels?boolean

Include the account's highlight reels.

Defaulttrue

curl -X GET "https://example.com/v1/instagram/user/highlights?user_id=787132" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "user": {      "has_public_story": true,      "is_live": true,      "reel": {        "id": "string",        "property1": null,        "property2": null      },      "property1": null,      "property2": null    },    "property1": null,    "property2": null  }}