GETProfiles2 credits
Get highlights
GET https://api.instagramapi.dev/v1/profile/highlightsReturns 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
| Name | Type | Required | Description |
|---|---|---|---|
| handle | string | yes | An 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 creditsExample 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.
| Field | Type | Description |
|---|---|---|
| items | array<object> | The profile's saved story highlights. |
| items[].id | string | Highlight id. |
| items[].title | string | The highlight's title. |
| items[].media_count | number | Number of stories saved in the highlight. |
| items[].created_at | string | When the highlight was created (ISO 8601, UTC). |
| items[].cover_image_url | string | URL of the highlight's cover image. |
| next_cursor | null | Always null. This endpoint returns a single page and isn't paginated. |