Instagram

Instagram Highlight Stories

Get every story saved in an Instagram highlight — media type, image and video URLs, posting time — by highlight id, as JSON. 2 credits.

POST/api/v1/instagram/highlight/stories

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

highlight_idstringrequired

The highlight id from User Highlights, with or without the highlight: prefix.

Example: highlight:18149897764550869

Notes

Credits. Typically 2 credits. A request can cost up to 10 credits when it needs extra work to answer; credits_used in the response is always the exact charge.

Fields. Stories are in data.items, oldest first. Each has media_type (1 photo, 2 video), taken_at, image_versions and, for videos, video_url and video_versions. Unlike live stories, highlights do not expire.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.instagram.highlight_stories(highlight_id="highlight:18149897764550869")
print(results)

Response

"response_time": 5797,

"credits_used": 2,

"credits_remaining": 4727

}