Instagram

Instagram User Highlights

List an Instagram user's story highlights — highlight id, title, cover image and story count — by username or user_id, as JSON. 2 credits.

POST/api/v1/instagram/user/highlights

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

usernamestring

Instagram username (without @). Provide this or user_id.

Example: mrbeast

user_idstring

Numeric user id. Provide this or username.

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.

Next step. Highlights are in data.items. Pass a highlight's id (for example highlight:18149897764550869) to Highlight Stories to get every story saved in it.

Fields. title, media_count (stories in the highlight), created_at, and cover_media.cropped_image_version.url for the cover.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.instagram.user_highlights(username="mrbeast")
print(results)

Response

"pagination_token": null

"response_time": 2050,

"credits_used": 2,

"credits_remaining": 4727

}