Documentation menu
Posts

List Instagram stories

List an Instagram account's live stories, with when each expires.

GEThttps://app.tryadeli.com/api/v1/posts/instagram/stories
AuthorizationBearer <API key>How keys work

List an Instagram account's active stories: everything it posted in the last 24 hours, newest first. Use it to let someone pick a story, for example to run an automation only on replies to that story: the story's id is the story.id on its replies, and passing it as storyId to List messages returns everyone who replied.

The list comes live from Instagram on every call, so a story posted a moment ago shows up straight away, and one that has expired is gone.

Query parameters

accountIduuidRequired
The connected Instagram account.
profileIduuid
Optional, because accountId names its profile. If you pass both, they must agree.

Each story has:

Story fields

idstring
The story's Instagram media id.
mediaTypestring | null
IMAGE or VIDEO.
mediaProductTypestring
Always STORY.
mediaUrlstring | null
The image or video. Null for a video with licensed music; show thumbnailUrl instead.
thumbnailUrlstring | null
A video story's cover image. Null for images.
permalinkstring | null
The story on Instagram. It opens only while the story is live.
timestampdate-time
When the story was posted.
expiresAtdate-time
When the story stops being live, 24 hours after timestamp.

Only live stories

Instagram keeps a story for 24 hours, and so does this list. Media URLs stop working when the story expires, so copy anything you want to keep. Live video broadcasts and stories reshared from other accounts are never included.

The account needs the basic read permission that every Instagram connection has. An account with no live stories returns "stories": [].

Errors — 401 unauthorized, 400 invalid_request, 404 profile_not_found, 404 account_not_found, 403 permission_required with missing permission and reconnect details, 422 connection_expired, 502 provider_error.