Instagram User Highlights (V3)

https://api.sandbase.ai/v1/api/instagram/v3/user-highlights

Returns profile highlights for a specified Instagram account. Supports forward and backward cursor-based pagination to browse collections.

Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 4 optional
Production route

Try the model

Playground

Open playground
Input
Forward pagination cursor, from previous response `data.page_info.end_cursor`
Backward pagination cursor, from previous response `data.page_info.start_cursor`
150
Number of highlights per page (default 10, max 50) Range: 1 to 50.
Highlights per page for backward pagination, use with `before`
Instagram username (required)
OutputExample
Responseoutputs · 14.5 KB · 288 lines
[
  {
    "data": {
      "_rid": "33fde7ae308e4",
      "count": 7,
      "items": [
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/756700225_1653985762331725_8429300849500507026_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=NRirPknCIUoQ7kNvwEdXxUe&_nc_oc=AdrLoF_S43nb8V6PmYx8GjH4XfgPj9JTvmu6MK3n45qEFFlQNcJYlL4edx0Pde-lBw4&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQO7ueR1AMhCJolIpqaXQEyyaUmht67kYwUyplTaH48bZA&oe=6AC18EFE",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2024-06-28T20:31:11Z",
          "id": "highlight:18223279177302854",
          "media_count": 52,
          "pk": "18223279177302854",
          "title": "close friends"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/755867844_1751720619182762_5430881549273743299_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=XXsKiZVU-g4Q7kNvwGhh4F4&_nc_oc=AdoGee1gGLzrAOxOLrM7W9KyAjH6TNxvVBQS6l9WI6GT8J9Otkapaquq1GlSI36cboY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQOzHMuJiSsPsY7AMcSJDKVgZ03S60PlTIvLjf4AjdkZUw&oe=6AC1932F",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-21T22:50:39Z",
          "id": "highlight:18612622252018257",
          "media_count": 46,
          "pk": "18612622252018257",
          "title": "🎤🎶🎸"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/755331856_1609699020573638_4426177467586352650_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=a7-mhagr6bkQ7kNvwFG5VEV&_nc_oc=AdppEpdCLpwXQNKcgyYUsUYHNVpz3mf9nRbRNmznBVhi6jdQXSbrGvrsOzHSxU-t_vw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQO_P1NA8rVrhm0v0wCvzwZQeE4QhQ8_bviAxZxRjnSABg&oe=6AC18773",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2024-04-18T16:14:01Z",
          "id": "highlight:18029499352961095",
          "media_count": 47,
          "pk": "18029499352961095",
          "title": "what’s new"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/756661521_3289512177887855_4009891805420027177_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=_CsMzItupEIQ7kNvwHR8hRn&_nc_oc=AdpySfy2bgPEmPd5XDGCh1QEraRHAAVeOfaogOrg-H0zGr_ZduKMKxIJePA3TSxna9k&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQMl6E-yOxeuJwpb7RAOME3YMNdiNdMJ_N-ThtmpSz7Eyw&oe=6AC19257",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-22T21:01:58Z",
          "id": "highlight:18142207969557132",
          "media_count": 52,
          "pk": "18142207969557132",
          "title": "creatives"
        },
        {
          "cover_media": {
            "crop_rect": [
              0.26436900198262,
              0.183164194209,
              0.79633101816717,
              0.4823928283128
            ],
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.82787-15/575724433_18680673526001321_5945490939444494882_n.jpg?stp=c309.380.622.622a_dst-jpg_e35_s150x150_tt6&_nc_cat=1&ig_cache_key=Mzc2NDM2NTI3MzkyMzEwNDAzNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6Ij8ueHBpZHMuMTE3MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=o-2-F-yTnngQ7kNvwEzl9yb&_nc_oc=Adp3-f8ocr_2hx7yoXQ-nfitFgr4mVpNl7jCs_KwDeL5oFw217R1VNxNokn2ef_n6mI&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPeVYlOAZb1SBBabhjPa8XjrhJClBWVLYzV74mZZLvq3A&oe=6AC1A1C9",
              "width": 150
            },
            "full_image_version": null,
            "media_id": "3764365273923104036_25025320",
            "upload_id": null
          },
          "created_at": "2026-07-21T21:57:40Z",
          "id": "highlight:18032893448824228",
          "media_count": 23,
          "pk": "18032893448824228",
          "title": "🎾🏀⚽️"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia3-2.cdninstagram.com/v/t51.71878-15/775233495_1033957092733525_6010470506239881158_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=7-5&_nc_sid=acbce5&_nc_ohc=9xZraihBXiEQ7kNvwF1b1Sz&_nc_oc=Adr1NR5dJrhASgS45gMg7MqKrABvy4XJeoWBx510ZNisRG1XqiBGUmbO1m9aC5VxMVk&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPhk1O-UWmSBDSGNv_huctCFc_Ge5S7I2AAm-2H6Cj-gA&oe=6AC18F39",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-08-21T17:35:07Z",
          "id": "highlight:18125969650775954",
          "media_count": 3,
          "pk": "18125969650775954",
          "title": "🚗🚗🚗"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/755264526_1764587937905767_5811150211834945970_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&ccb=7-5&_nc_sid=acbce5&_nc_ohc=3o2yG-zzE14Q7kNvwF3NA5y&_nc_oc=AdrF1jUWuTUCQYzWmCS9kMOU1A0CZL2PfVhJj0U8kBQxa0V3rMt6cryO3rM6diFEMwA&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPD02r7RoOYMikPTpt7d18A0Fm9WGNLr13nOEdwE7esOw&oe=6AC1A2B9",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-21T22:03:44Z",
          "id": "highlight:18194686561332120",
          "media_count": 17,
          "pk": "18194686561332120",
          "title": "🎥🌟🍿"
        }
      ],
      "tray": [
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/756700225_1653985762331725_8429300849500507026_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=NRirPknCIUoQ7kNvwEdXxUe&_nc_oc=AdrLoF_S43nb8V6PmYx8GjH4XfgPj9JTvmu6MK3n45qEFFlQNcJYlL4edx0Pde-lBw4&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQO7ueR1AMhCJolIpqaXQEyyaUmht67kYwUyplTaH48bZA&oe=6AC18EFE",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2024-06-28T20:31:11Z",
          "id": "highlight:18223279177302854",
          "media_count": 52,
          "pk": "18223279177302854",
          "title": "close friends"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/755867844_1751720619182762_5430881549273743299_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=XXsKiZVU-g4Q7kNvwGhh4F4&_nc_oc=AdoGee1gGLzrAOxOLrM7W9KyAjH6TNxvVBQS6l9WI6GT8J9Otkapaquq1GlSI36cboY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQOzHMuJiSsPsY7AMcSJDKVgZ03S60PlTIvLjf4AjdkZUw&oe=6AC1932F",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-21T22:50:39Z",
          "id": "highlight:18612622252018257",
          "media_count": 46,
          "pk": "18612622252018257",
          "title": "🎤🎶🎸"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/755331856_1609699020573638_4426177467586352650_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=a7-mhagr6bkQ7kNvwFG5VEV&_nc_oc=AdppEpdCLpwXQNKcgyYUsUYHNVpz3mf9nRbRNmznBVhi6jdQXSbrGvrsOzHSxU-t_vw&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQO_P1NA8rVrhm0v0wCvzwZQeE4QhQ8_bviAxZxRjnSABg&oe=6AC18773",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2024-04-18T16:14:01Z",
          "id": "highlight:18029499352961095",
          "media_count": 47,
          "pk": "18029499352961095",
          "title": "what’s new"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.71878-15/756661521_3289512177887855_4009891805420027177_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=acbce5&_nc_ohc=_CsMzItupEIQ7kNvwHR8hRn&_nc_oc=AdpySfy2bgPEmPd5XDGCh1QEraRHAAVeOfaogOrg-H0zGr_ZduKMKxIJePA3TSxna9k&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQMl6E-yOxeuJwpb7RAOME3YMNdiNdMJ_N-ThtmpSz7Eyw&oe=6AC19257",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-22T21:01:58Z",
          "id": "highlight:18142207969557132",
          "media_count": 52,
          "pk": "18142207969557132",
          "title": "creatives"
        },
        {
          "cover_media": {
            "crop_rect": [
              0.26436900198262,
              0.183164194209,
              0.79633101816717,
              0.4823928283128
            ],
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia5-2.cdninstagram.com/v/t51.82787-15/575724433_18680673526001321_5945490939444494882_n.jpg?stp=c309.380.622.622a_dst-jpg_e35_s150x150_tt6&_nc_cat=1&ig_cache_key=Mzc2NDM2NTI3MzkyMzEwNDAzNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6Ij8ueHBpZHMuMTE3MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=o-2-F-yTnngQ7kNvwEzl9yb&_nc_oc=Adp3-f8ocr_2hx7yoXQ-nfitFgr4mVpNl7jCs_KwDeL5oFw217R1VNxNokn2ef_n6mI&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPeVYlOAZb1SBBabhjPa8XjrhJClBWVLYzV74mZZLvq3A&oe=6AC1A1C9",
              "width": 150
            },
            "full_image_version": null,
            "media_id": "3764365273923104036_25025320",
            "upload_id": null
          },
          "created_at": "2026-07-21T21:57:40Z",
          "id": "highlight:18032893448824228",
          "media_count": 23,
          "pk": "18032893448824228",
          "title": "🎾🏀⚽️"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia3-2.cdninstagram.com/v/t51.71878-15/775233495_1033957092733525_6010470506239881158_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=105&ccb=7-5&_nc_sid=acbce5&_nc_ohc=9xZraihBXiEQ7kNvwF1b1Sz&_nc_oc=Adr1NR5dJrhASgS45gMg7MqKrABvy4XJeoWBx510ZNisRG1XqiBGUmbO1m9aC5VxMVk&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPhk1O-UWmSBDSGNv_huctCFc_Ge5S7I2AAm-2H6Cj-gA&oe=6AC18F39",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-08-21T17:35:07Z",
          "id": "highlight:18125969650775954",
          "media_count": 3,
          "pk": "18125969650775954",
          "title": "🚗🚗🚗"
        },
        {
          "cover_media": {
            "crop_rect": null,
            "cropped_image_version": {
              "height": 150,
              "scans_profile": "",
              "url": "https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/755264526_1764587937905767_5811150211834945970_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=107&ccb=7-5&_nc_sid=acbce5&_nc_ohc=3o2yG-zzE14Q7kNvwF3NA5y&_nc_oc=AdrF1jUWuTUCQYzWmCS9kMOU1A0CZL2PfVhJj0U8kBQxa0V3rMt6cryO3rM6diFEMwA&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=cjeEvkW9_pPgzQSNhCL6oQ&_nc_ss=7e3ba&oh=00_AQPD02r7RoOYMikPTpt7d18A0Fm9WGNLr13nOEdwE7esOw&oe=6AC1A2B9",
              "width": 150
            },
            "full_image_version": null,
            "media_id": null,
            "upload_id": null
          },
          "created_at": "2026-07-21T22:03:44Z",
          "id": "highlight:18194686561332120",
          "media_count": 17,
          "pk": "18194686561332120",
          "title": "🎥🌟🍿"
        }
      ]
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

username
string · required
after
string · optional
before
string · optional
first
integer · optional
last
integer · optional

Access

Provider
Instagram
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/instagram/v3/user-highlights
Authentication
Bearer API key

API README

Instagram User Highlights (V3) API

Retrieve highlight collections for an account by providing username. Navigate through result pages using first, after, before, and last.

Use cases

  • Display story highlight reels from an account profile.
  • Archive story highlight collections for creator monitoring.
  • Navigate paginated highlight feeds across public profiles.

Request

curl -X POST "https://api.sandbase.ai/v1/api/instagram/v3/user-highlights" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "instagram"}'

Parameters

NameTypeRequiredDescription
usernamestringYesInstagram username (required)
lastintegerNoHighlights per page for backward pagination, use with before
afterstringNoForward pagination cursor, from previous response data.page_info.end_cursor
firstintegerNoNumber of highlights per page (default 10, max 50)
beforestringNoBackward pagination cursor, from previous response data.page_info.start_cursor

Notes

  • first sets the number of highlights returned per page (default 10, max 50).
  • Use after with data.page_info.end_cursor from the previous response for forward pagination.
  • Use before with last and data.page_info.start_cursor for backward pagination.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/instagram/v3/user-highlights
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/instagram/v3/user-highlights" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "first": 5,
  "username": "instagram"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Instagram$0.01 per callJSONJul 31, 2026
Instagram$0.01 per callJSONJul 31, 2026
Instagram$0.01 per callJSONJul 31, 2026
Instagram$0.01 per callJSONJul 31, 2026
Instagram$0.003 per callJSONJul 31, 2026
Instagram$0.01 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Instagram User Highlights (V3) API?

Send a POST request to https://api.sandbase.ai/v1/api/instagram/v3/user-highlights with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Instagram User Highlights (V3) API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Instagram User Highlights (V3) API accept?

Required: username (string). Optional: after (string), before (string), first (integer) and last (integer). The Parameters table and the Playground on this page list every field.

What does the Instagram User Highlights (V3) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Instagram developer account or API key?

No. Instagram User Highlights (V3) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Instagram API access separately.