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 の使い方
ユーザー名を送信し、タスクの完了を待って、タスクの結果からストーリーズを読み取ります。
- 確認したい公開アカウントを選びます(例:natgeo)。
- {"username": "natgeo"} を /v1/instagram/stories に POST し、レスポンスの task_id を保持します。
- status が succeeded になるまで、数秒おきに GET /v1/tasks/{task_id} を呼び出します。
- 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を使用してください。
関連API
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 Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Post Info API
- Instagram Reels Search API
- Instagram Trending Reels API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API