instagram/
stories

公開Instagramアカウントが現在公開しているストーリーズをユーザー名から収集し、各ストーリーの画像または動画、投稿日時と有効期限、リンクスタンプを返します。

Instagram Stories API

ユーザー名を入力
ライブ中のストーリーズ
リンクスタンプ
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Instagram Stories

Instagramのストーリーズは、アカウントが24時間限定で共有する写真や動画で、リンクスタンプ、タグ付けしたアカウント、期間限定のオファーなど、メインのフィードには載らない情報が含まれていることもよくあります。公開されている間に保存しておけば、ブランド、マーケティング、リサーチの各チームが、そのままでは消えてしまう新商品の発表、プロモーション、クリエイターの動きを記録として残せます。

Instagram Stories API の主な機能

  • アカウントが公開中のすべてを取得ユーザー名を1つ送信すると、リクエストした時点でそのアカウントが公開しているストーリーズがすべて返されます。
  • そのままアーカイブできるメディア各ストーリーには、画像または動画のURL、幅と高さ、カバー画像が含まれるため、コンテンツを保存したり後から確認したりできます。
  • 公開された時刻と消える時刻投稿日時は published_at、有効期限は extra.expires_at で返されるため、次の収集までにどれだけ猶予があるかを正確に把握できます。
  • リンクとメンションもストーリーに紐づくリンクスタンプの遷移先は extra.link_urls に、タグ付けされたアカウントは extra.mentions に、それぞれを含んでいたストーリーに紐づいて記録されます。

Instagram Stories API のパラメータ

パラメータ必須説明
username必須現在のストーリーズを取得したい公開Instagramアカウントのユーザー名です。先頭の @ は省略できます。

Instagram Stories API の使い方

ユーザー名を送信し、タスクの完了を待って、タスクの結果からストーリーズを読み取ります。

  1. 確認したい公開アカウントを選びます(例:natgeo)。
  2. {"username": "natgeo"} を /v1/instagram/stories に POST し、レスポンスの task_id を保持します。
  3. status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} を呼び出します。
  4. results.items からストーリーズを読み取ります。results.has_more が true の場合は、results.next_cursor を渡して次のページを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/stories" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"natgeo"}'

# The response contains a task_id.
# GET /v1/tasks/{task_id} returns the stories once status is succeeded.

Instagram Stories API の主なユースケース

  • ストーリーズの日次アーカイブ: ブランドのストーリーズを1日に1〜2回収集してメディアと投稿日時を保存しておけば、期限切れ後もすべてのストーリーを確認できます。
  • プロモーションの追跡: 競合がストーリーズに追加するリンクスタンプのURLを追い、今週どの商品、セール、ランディングページを押し出しているかを把握します。
  • クリエイター施策の確認: クリエイターのストーリーの投稿時刻、メディア、リンクスタンプを依頼内容と照合し、合意したストーリーが公開されたことを確認します。

Instagram Stories API 活用のヒント

  • ライブ中にすべてのストーリーを最低1回は収集できるよう、実行間隔は24時間未満にしてください。
  • ストーリーのメディアリンクは一時的なCDNアドレスのため、残したい画像や動画は収集後すぐにダウンロードしてください。
  • 同じアカウントを再度収集するときは、ストーリーの id を使って保存済みのストーリーをスキップしてください。
  • アカウントがプロフィールに残しているストーリーズについては、Instagram Story HighlightsとInstagram Highlight Itemsを使用してください。

Instagram Stories API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
  • Instagram Story Highlights API — ユーザー名から公開ストーリーズハイライトの一覧を取得し、タイトル、所有者情報、メディア数、再利用可能なハイライトIDを返します。
  • Instagram Similar Accounts API — ユーザー名に対してInstagramが類似アカウントとして提案するアカウントを一覧で取得し、ユーザー名、名前、アイコン、認証バッジの有無を返します。

他のプラットフォームを見る

Instagramのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Stories API — よくある質問

Instagram Stories APIは、公開Instagramアカウントが現在公開しているストーリーズを、ユーザー名を入力として収集するAPIです。各ストーリーのIDとリンク、画像または動画、カバー画像、投稿者、投稿日時を返します。

はい。公開アカウントのユーザー名を送信すると、ストーリーズがデータとして返され、Instagramへのログインは必要ありません。

ストーリーにリンクスタンプが付いている場合、そのスタンプの遷移先URLが、該当ストーリーの extra.link_urls に返されます。

ストーリーズは24時間公開されるため、1日に1〜2回収集すれば、ライブ中のすべてのストーリーを取得できます。

プロフィールが見つからなかったというメッセージとともにタスクが終了し、保留されていたクレジットは残高に戻されます。

返されたストーリー1件につき0.5クレジットで、ライブ中のストーリーが見つからなかったリクエストは無料です。