Instagram Story Highlights
Instagramストーリーズのハイライトは、公開プロフィールに保存されたストーリーズのコレクションで、タイトルごとに整理され、所有者情報、カバーメディア、アイテム数を備えています。これらのコンテナレコードは、プロフィールのカテゴリ一覧の作成、アカウント間の比較、アイテム単位で確認するハイライトの選定に活用できます。
Instagram Story Highlights API の主な機能
- 複数プロフィールのハイライト一覧1つ以上のInstagramユーザー名を送信し、所有者情報を保持したまま、各アカウントで公開されているストーリーズのハイライトのコンテナを一覧化します。
- コンテナの識別情報とコンテキスト正規化されたハイライトID、タイトル、URL、所有者情報、直接公開されているメディア、タイムスタンプ、公開数値、報告されたアイテム総数を受け取れます。
- アイテム単位の取得への受け渡しextra.highlight_id でコンテナとの関係を保持し、数値のハイライトIDをアイテム単位の収集ワークフローに渡せます。
Instagram Story Highlights API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 空でないハンドルで指定する1つ以上の公開Instagramユーザー名です。先頭の @ は受け付け、収集前に除去されます。 |
Instagram Story Highlights API の使い方
公開アカウントのユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、正規化されたハイライトのコンテナを結果カーソルのページネーションで読み取ります。
- プロフィールURLではなくハンドルとして、1つ以上の公開Instagramユーザー名を用意します。
- usernames を /v1/instagram/story-highlights に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、results.has_more が true の間は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/story-highlights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["instagram"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueInstagram Story Highlights API の主なユースケース
- 公開プロフィールのカテゴリ一覧: ハイライトのタイトル、所有者情報、URL、メディア数を整理し、プロフィールで公開されている保存済みストーリーズのカテゴリ一覧を作成します。
- アカウント間のハイライト比較: 送信した公開ユーザー名の間で、コンテナのタイトル、報告されたアイテム総数、メディアの参照情報、取得可能なタイムスタンプを比較します。
- ストーリーズのコレクション選定: extra.highlight_id をタイトルや media_count とあわせて使い、後続のアイテム単位の取得に回す数値のハイライトコンテナを選びます。
Instagram Story Highlights API 活用のヒント
- プロフィールURLはハンドルに変換されないため、送信前に先頭の @ を取り除き、得られたユーザー名の重複を排除してハンドルを正規化してください。
- ユーザー名ごとにハイライト一覧のリクエストは1回で、results_limit やプロバイダー側の継続取得はありません。そのため、各アカウントで収集されるレコードは、取得可能なコンテナ一覧によって決まります。
- タスク結果の next_cursor は、保存済みの正規化レコードをページ送りするためだけに使ってください。Instagramにハイライトの次のページをリクエストするものではありません。
- 個々のストーリーズのフレームが必要な場合は、存在する数値の extra.highlight_id の値だけを instagram/highlight-items に渡してください。
- 結果が空の場合は、ハイライトがない、またはプロフィールが利用できない可能性があるものとして扱い、任意のメディア、指標、URL、タイムスタンプがあることを前提にしないでください。
関連API
Instagram Story Highlights API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。
- Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
- Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
- Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
- Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
- Instagram Highlight Items API — 既知のハイライトIDから、保存された公開ストーリーズの項目を、テキスト、投稿者情報、メディア、タイムスタンプ、表示中の指標、取得元の情報とともに取得します。
- Instagram Stories API — ユーザー名から、公開アカウントが現在公開中のストーリーズを収集し、ストーリーのメディア、投稿時刻、有効期限を返します。
- 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 Post Info API
- Instagram Reels Search API
- Instagram Trending Reels API
- Instagram Similar Accounts 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