Stories

Updated: Jan 21, 2025

Copy for LLM

View as Markdown

Represents a collection of story IG Media objects on an IG User.

Creating

For creating Stories Media, refer to the Instagram User Media documentation.

Reading

Getting Stories

GET /{ig-user-id}/stories

Returns a list of story IG Media objects on an IG User.

Limitations

Responses will not include Live Video stories.

Stories are only available for 24 hours.

New stories created when a user reshares a story will not be returned.

Only one caption will be returned per Instagram story, even if more than one caption exists.

Permissions

A Facebook User access token with the following permissions:

instagram_basic

pages_read_engagement

If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required:

ads_management

ads_read

Sample Request

GET graph.facebook.com
  /17841405822304914/stories

Sample Response

{
  "data": [
    {
      "id": "17861937508009798"
    },
    {
      "id": "17862253585030136"
    },
    {
      "id": "17856428680064034"
    },
    {
      "id": "17862537148046301"
    },
    {
      "id": "17852121721080875"
    },
    {
      "id": "17862694123018235"
    }
  ]
}

Updating

This operation is not supported.

Deleting

This operation is not supported.