Instagramクリエイターのストーリーズを取得（リアルタイム）

リクエスト時点でInstagramクリエイターが公開中のストーリーズを取得します。ストーリーズは24時間で消えるためリアルタイム専用で、データベース読み取りよりクォータを多く消費します。

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

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 100 単位消費されます。

リクエストパラメータ

必須パラメータ

名前	位置	型	説明
`user_id`	query	string	user_id example: 13460080

レスポンスフィールド

名前	型	説明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.user`	object	user
`data.stories`	array<object>	stories

お試し実行

リクエストURL

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

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

user_id*

cURL の例

bash

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

レスポンス例 (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
          }
        ]
      }
    ]
  }
}

ユースケース

ストーリーズ納品確認 — スポンサーストーリーズが消える前に、合意した時間内に投稿されたことを確認します。
リンク配置の監査 — ストーリーズに計測リンクや商品ステッカーが含まれているかを確認します。