Get Instagram Creator Stories (Realtime)

Fetches the stories an Instagram creator has live at request time. Stories expire after 24 hours, so this endpoint is realtime only and costs more quota than database reads.

GET/api/v1/instagram/realtime/user/stories

Quota usage: Each successful request to this endpoint deducts 100 quota units from your plan.

Request Parameters

Required Parameters

Name	In	Type	Description
`user_id`	query	string	user_id example: 13460080

Response Fields

Name	Type	Description
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.user`	object	user
`data.stories`	array<object>	stories

Try It

Request URL

https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

Query Params

user_id*

cURL Example

bash

curl -X GET "https://openapi.scdata.cc/api/v1/instagram/realtime/user/stories?user_id=13460080" \
  -H "Authorization: YOUR_API_KEY"

Response Example (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "user": {
      "user_id": "string",
      "username": "string",
      "full_name": "string",
      "is_private": true,
      "is_verified": true,
      "avatar": "string"
    },
    "stories": [
      {
        "media_id": "string",
        "media_code": "string",
        "create_at": "2019-08-24T14:15:22.123Z",
        "expiring_at": "2019-08-24T14:15:22.123Z",
        "media_type": 0,
        "cover_url": "string",
        "video_url": "string",
        "video_duration": "string",
        "mention_users": [
          {
            "user_id": "string",
            "username": "string",
            "full_name": "string",
            "is_private": true,
            "is_verified": true,
            "avatar": "string"
          }
        ],
        "locations": [
          {
            "location_id": "string",
            "name": "string",
            "address": "string",
            "city": "string",
            "latitude": 0,
            "longitude": 0
          }
        ]
      }
    ]
  }
}

Use Cases

Story deliverable verification — Confirm a sponsored story was posted within the agreed window before it disappears.
Link placement audit — Check that the tracking link or product sticker was included in the story.