Meta Developer Docs

Appearance

Fresh 2026

Stories ​

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 ​

text
GET graph.facebook.com
  /17841405822304914/stories

Sample Response ​

json
{
  "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.