Instagram Stories in a highlight API

Read the stories in a highlight from its highlight_id: each row has media_url, media_type, posted_at and highlight_title, for $0.56 per 1,000 calls.

  • highlight_id comes from the id in highlights
  • One response, with no paging
  • shared_post_url shows the post a story shares

API health

24h health
Normal
  • Healthy / normal
  • Available
  • Limited
  • Mostly down
Normal

Last 24 hours

Last 30 days

  1. 1Request

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "highlight_stories",
      "params": {
        "highlight_id": "18023864549864045"
      }
    }
  2. 2JSON response

    {
      "results": [
        {
          "author_username": "n•••o",
          "media_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…",
          "media_type": "video",
          "duration_seconds": 9.943
        },
        …
      ],
      "count": 8
    }
  3. 3Rows

    author_usernamemedia_urlmedia_typeduration_seconds
    n•••ohttps://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…video9.943
    n•••ohttps://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…video11.6
  4. 4CSV

    instagram-highlight_stories-sample.csv id,url,media_url,media_type,duration_seconds,duration_sec,posted_at,author_username,author_name,author_avatar_url,author_is_verified,platform,image_url,video_url,width,height,is_paid_partnership,links,mentions,hashtags,sponsors,music,author_id,highlight_id,shared_post_url,highlight_title

A request with highlight_id returns the stories in the highlight. Each story is a row with media_url, media_type, posted_at and more, ready as a field table or a CSV.

What data you get

Each row is one story in the highlight. The table shows rows from a real call for 18023864549864045, captured November 21, 2026 at 07:18 (UTC), that returned 8 rows. Gray bars cover personal information that was removed (••• in the CSV). Your own calls return the fields listed in the field reference.

idurlmedia_urlmedia_typeduration_secondsduration_secposted_atauthor_usernameauthor_nameauthor_avatar_urlauthor_is_verifiedplatformimage_urlvideo_urlwidthheightis_paid_partnershiplinksmentionshashtagssponsorsmusicauthor_idhighlight_idshared_post_urlhighlight_title
https://www.instagram.com/stories/highlights/18023864549864045/https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…video9.9439.9432026-10-20T13:14:30+00:00n•••onulltrueinstagramhttps://scontent-lax3-1.cdninstagram.com/v/t51.71878-15/858981307_2584622395349397_7318871625928867813_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMjEyMDU2NzExNzM1NDYyNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…7201280false["https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261020travel-bestoftheworld2027freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAacDA3R…"]nullnullnullnull18023864549864045https://www.instagram.com/p/Det5B-rAng2/BOTW 2027
https://www.instagram.com/stories/highlights/18023864549864045/https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…video11.611.62026-10-23T14:02:48+00:00n•••onulltrueinstagramhttps://scontent-lax3-2.cdninstagram.com/v/t51.71878-15/864999986_1898267698207346_8225834360306799682_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDMxOTE4NjgyMTUzNTM4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…7201280false["https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261023travel-botw2027capecinematic1freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAad…"]nullnullnullnull18023864549864045nullBOTW 2027

Use cases

  • Save the highlight's media

    Fetch the images and videos in the highlight from media_url. Links can expire, so download them soon.

  • Tell images from videos

    Read media_type and duration_seconds to handle image stories and video stories separately.

  • Find shared posts

    A story with a shared_post_url shares a post. Use that link to read the post.

  • List the links and tags in stories

    Read links, mentions and hashtags to see which links a story cites, whom it mentions and which hashtags it uses.

Instagram Help Center vs EveryInfra

The Instagram Help Center page on highlights (not API documentation) and EveryInfra highlight_stories, compared on how long a highlight lasts and who can see it.

ComparedInstagram Help CenterEveryInfra
How long it lasts"Stories you add as highlights remain visible as highlights until you remove them, even after the original story has disappeared."highlight_stories reads the stories that are in the highlight now, in one response with no paging. Each story has posted_at.
Who can see it"Keep in mind that those you've allowed to see your story can also see your highlights."When the highlight does not exist, has been deleted, or belongs to a private account, the call returns an empty result with no charge.

Quotes are from the Instagram Help Center, checked 2026-11-22; the page shows no update date. This is a Help Center page, not API documentation. Official sources: Add a story to your Story Highlights

Limits and gotchas

  • highlight_id is required: the id from a highlights result (a string of digits). You can also pass the highlight link.
  • The stories in the highlight come back in one response, with no paging. The maximum number is in the parameter reference.
  • When the highlight does not exist, has been deleted, or belongs to a private account, the call returns an empty result with no charge.
  • Media links are signed and can expire, so download what you need soon.
  • shared_post_url appears only on stories that share a post.

Pricing

Each call costs $0.000556, whatever the number of stories, and reads one highlight. Failed calls and empty results are not charged.

CallsCost
10,000$5.56
100,000$55.56
1,000,000$555.56

Totals use the list price per call.

Code samples

#
bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "instagram",
  "action": "highlight_stories",
  "params": {
    "highlight_id": "18023864549864045"
  }
}'

OpenAPI definition (JSON)Samples read the key from the EVERYINFRA_API_KEY environment variable; copied code never contains your key.

API reference

See the parameters, response fields, errors and billing for highlight_stories, and copy the page or open it as Markdown for an AI assistant.

POST

AI prompt

#
Please help me write a data collection script with the EveryInfra Instagram Stories in a highlight endpoint (instagram/highlight_stories).

How the endpoint works:
- Request: POST https://api.everyinfra.com/api/v1/social with the header Authorization: Bearer <API key>. Read the key from the EVERYINFRA_API_KEY environment variable and never hard-code it.
- In the request body, set platform to instagram and action to highlight_stories, and put the parameters inside params.
- Required parameters:
  - highlight_id: The highlight ID: the id from highlights (a string of digits), or a highlight link https://www.instagram.com/stories/highlights/<id>/.
- Returns a list of records. Main fields of each record: id, url, media_url, media_type (Only two values: video (videos), duration_seconds, duration_sec (Duration, in seconds), posted_at, author_username, author_name, author_avatar_url (Author avatar URL), author_is_verified (Whether the author's account has a veri…), image_url; 25 fields in total, full list at https://api.everyinfra.com/api/v1/social/catalog?platform=instagram.
- Example request body:
{
  "platform": "instagram",
  "action": "highlight_stories",
  "params": {
    "highlight_id": "18023864549864045"
  }
}
- Price: $0.56 per 1,000 requests; failed and empty results are not charged.
- For dozens or hundreds of targets, add "mode": "async" to the body: you get a job_id at once and poll GET https://api.everyinfra.com/api/v1/jobs/{job_id} for the result.
- On 422, fix the request using the suggested parameter names and allowed values in the error; on 429 or 503, wait for Retry-After and try again.

Before writing code, ask me which targets I need, how many, which fields, and what output format I want; then confirm the plan and the rough cost with me.

Request parameters

#
NameInTypeRequiredDefaultDescription
AuthorizationheaderstringYes-Bearer followed by your API key. Create it in the console; never put it in a URL or a code repository.
platformbodystringYesinstagramPlatform identifier, fixed value.
actionbodystringYeshighlight_storiesCapability identifier, fixed value.
highlight_idbody.paramsstringYes-The highlight ID: the id from highlights (a string of digits), or a highlight link https://www.instagram.com/stories/highlights/<id>/.

Response example

#
Captured November 21, 2026 at 07:18 (UTC) by calling this API with the parameters in the code sample above. results and count are that call's real response with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2. id, billing and quota differ on every call, so only their shape is shown.
json
{  "id": "req_…",  "platform": "instagram",  "action": "highlight_stories",  "results": [    {      "id": "•••",      "url": "https://www.instagram.com/stories/highlights/18023864549864045/",      "media_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…",      "media_type": "video",      "duration_seconds": 9.943,      "posted_at": "2026-10-20T13:14:30+00:00",      "author_username": "n•••o",      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "author_is_verified": true,      "platform": "instagram",      "image_url": "https://scontent-lax3-1.cdninstagram.com/v/t51.71878-15/858981307_2584622395349397_7318871625928867813_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=106&_nc_map=urlgen_bucketless&ig_cache_key=NDAxMjEyMDU2NzExNzM1NDYyNA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…",      "video_url": "https://scontent-lax3-2.cdninstagram.com/o1/v/t2/f2/m78/AQPyy1nSmXOn73Q1QB0NVznCvo1RmXxggQMktLVDCIUMzEKO_6-0Qil9pON54uB0l9mHyflRzzzRAJIhXoDdyiKX2f5h01zsvcDNEWk.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-lax3-2.cdninstagram.com&_nc_ohc=BRkOnUltoGkQ7kNvwEHT8Cq&efg=eyJ2ZW5jb2RlX…",      "width": 720,      "height": 1280,      "is_paid_partnership": false,      "links": [        "https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261020travel-bestoftheworld2027freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAacDA3R…"      ],      "author_id": "•••",      "highlight_id": "18023864549864045",      "shared_post_url": "https://www.instagram.com/p/Det5B-rAng2/",      "highlight_title": "BOTW 2027",      "duration_sec": 9.943    },    {      "id": "•••",      "url": "https://www.instagram.com/stories/highlights/18023864549864045/",      "media_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…",      "media_type": "video",      "duration_seconds": 11.6,      "posted_at": "2026-10-23T14:02:48+00:00",      "author_username": "n•••o",      "author_avatar_url": "https://scontent-lax3-1.cdninstagram.com/•••",      "author_is_verified": true,      "platform": "instagram",      "image_url": "https://scontent-lax3-2.cdninstagram.com/v/t51.71878-15/864999986_1898267698207346_8225834360306799682_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=NDAxNDMxOTE4NjgyMTUzNTM4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IlNUT1JZLnh…",      "video_url": "https://scontent-lax3-1.cdninstagram.com/o1/v/t2/f2/m78/AQPLKEWytHVc8yvGRCxvkwFQD69fFmCSPA_jwDC1r1PUhxmg0VNSKkO3oSvj2ugjosh8xpM0bk8l7kSRaOSuRIqewPTbUTgu4aNLrjg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_ohc=26vllBBhmb8Q7kNvwGIKzfQ&efg=eyJ2ZW5jb2RlX…",      "width": 720,      "height": 1280,      "is_paid_partnership": false,      "links": [        "https://www.nationalgeographic.com/travel/article/best-of-the-world-2027?cmpid=org%3Dngp%3A%3Amc%3Dsocial%3A%3Asrc%3Dinstagram%3A%3Acmp%3Deditorial%3A%3Aadd%3Digs20261023travel-botw2027capecinematic1freemium&fbclid=PAZXh0bgNhZW0CMTEAcGRvZgJzcnRjBmFwcF9pZA85MzY2MTk3NDMzOTI0NTkAAad…"      ],      "author_id": "•••",      "highlight_id": "18023864549864045",      "highlight_title": "BOTW 2027",      "duration_sec": 11.6    }  ],  "count": 8,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

Response fields

#

Business data is in results. The table lists the fields a record can contain; values the platform does not show are never made up.

FieldMeaning
idThe record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms.
urlLink to the record on the platform.
media_urlKeeps the platform's own meaning
media_typeOnly two values: video (videos; Reels are also video) and image (images; carousel posts are also recorded as image, and when product_type is present, a product_type of carousel_container marks a carousel).
duration_secondsDuration in seconds. null for content that is not video or audio.
duration_secDuration, in seconds.
posted_atPublish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it.
author_usernameAuthor's username (@handle), usually usable in URLs.
author_nameAuthor's display name.
author_avatar_urlAuthor avatar URL; signed link that expires.
author_is_verifiedWhether the author's account has a verified badge. Appears in user_posts, tagged_posts, location_posts, audio_posts, explore, stories and comment_replies, and in post, discover, reels, hashtag and reels_search rows when it has a value.
platformSource platform identifier, the same as platform in the request (for example xiaohongshu, tiktok).
image_urlImage link. Capabilities with several images may return an image_urls array.
video_urlVideo file URL: the complete mp4 with sound, playable directly. For a carousel post with videos, it is the first video; absent when the post is not a video. The link is signed and expires; when video_url_expires_at is present, go by it.
widthWidth of the original image or video, in pixels.
heightHeight of the original image or video, in pixels.
is_paid_partnershipWhether the post is marked "Paid partnership". Appears only when the page gives this information, and may be false.
links(stories) Addresses of the link stickers on the story, as an array.
mentionsUsernames @-mentioned in the text, as an array.
hashtagsHashtags in the text, in order of appearance; absent when there are none.
sponsorsUsernames of the brand accounts named in the paid partnership, as an array.
musicMusic used by the post or Reel, as an object: artist and title; some also carry audio_id (music ID), is_original (true for original audio recorded by the author, false for a song from the music library), is_explicit (whether a library song is marked explicit), is_trending (whether original audio is trending; original audio only) and url (the Instagram page for this music). For original audio, title is usually Original audio and artist is the username of its author. Absent when there is no music.
author_idAuthor's unique ID on the platform.
highlight_id(highlight_stories) The ID of the highlight the story is in, the same on every row.
shared_post_url(highlight_stories) The link of the post this story shares; absent on stories that share no post.
highlight_title(highlight_stories) The highlight's title, the same on every row.

Errors and billing

#
401
Missing or invalid key.
402
Insufficient balance. Top up first.
422
Invalid parameter name or value. Fix it using the suggestions in the error. No charge.
429
Per-minute request limit reached. Wait for Retry-After, then try again.
503
Could not complete. The held charge is returned to your balance. If the outcome is unknown, verify it before you retry.
200 empty
No data. No charge.

Errors

FAQ

What does the Instagram highlight stories endpoint return?

One row for each story in the highlight: id, url, media_url, media_type, duration_seconds, posted_at, author_username, highlight_title, shared_post_url and more.

Where do I get highlight_id?

Take it from the id in a highlights result. You can also pass the highlight link (https://www.instagram.com/stories/highlights/ plus the ID).

How much does it cost to read one highlight?

Billing is per call: $0.000556 each, or $0.56 per 1,000 calls, whatever the number of stories. Failed calls and empty results are not charged.

Do I need to log in to Instagram to read the stories in a highlight?

No. Put your EveryInfra API key in the Authorization: Bearer header. You need no Instagram login and no Instagram access token.

How do highlight_stories and highlights differ?

highlights lists the highlights an account has. highlight_stories reads each story in one highlight from its id.

The same EveryInfra API key also calls Instagram's other endpoints, such as highlights, which lists an account's highlights.

Google Analytics needs consent. Privacy