Instagram

Stories

List an account’s current stories.

Endpoint

GET
/s/instagram/stories

Send your API key in the X-API-Key header. instagram is the usual service slug; use the one shown on your subscription if it differs.

Query parameters

NameDescription
usernamerequired
Account name, with or without the leading @.Example: natgeo
userIdoptional
Numeric account ID, instead of username. Saves a lookup.

Example request

curl '/s/instagram/stories?username=natgeo' \
  -H 'X-API-Key: YOUR_API_KEY'

Example response

The result is in data. Fields the platform didn't report are left out. Field reference: response shapes.

{
  "data": {
    "items": [
      {
        "platform": "instagram",
        "id": "3456789012345678901",
        "type": "story",
        "createdAt": "2026-11-14T07:30:00Z",
        "expiresAt": "2026-11-15T07:30:00Z",
        "author": {
          "id": "787132",
          "username": "natgeo",
          "name": "National Geographic",
          "avatar": "https://cdn.example/avatar.jpg",
          "verified": false
        },
        "media": [
          {
            "type": "video",
            "url": "https://scontent.cdninstagram.example/story.mp4",
            "thumbnail": "https://scontent.cdninstagram.example/story.jpg",
            "duration": 5.2,
            "hasAudio": true
          }
        ],
        "stats": {}
      }
    ],
    "hasMore": false
  }
}

Notes