instagram/
story-highlights

ユーザー名から公開Instagramストーリーズのハイライトのコンテナを収集し、タイトル、所有者情報、メディア、アイテム数、再利用可能なハイライトIDを返します。

Instagram Story Highlights API

ユーザー名で検索
ハイライトのコンテナ
再利用可能なハイライトID
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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をポーリングして、正規化されたハイライトのコンテナを結果カーソルのページネーションで読み取ります。

  1. プロフィールURLではなくハンドルとして、1つ以上の公開Instagramユーザー名を用意します。
  2. usernames を /v1/instagram/story-highlights に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Instagram 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、タイムスタンプがあることを前提にしないでください。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Story Highlights API — よくある質問

Instagram Story Highlights APIは、送信したInstagramユーザー名から公開ストーリーズのハイライトのコンテナを一覧化するためのプログラムインターフェースです。正規化されたコンテナID、タイトル、所有者情報、メディア、公開数値、アイテム数、再利用可能なハイライトIDを返します。

Instagramアカウントのハンドルを、空でない配列で送信してください。先頭の @ は除去されますが、プロフィールURLはユーザー名に変換されないため、送信前にハンドルを正規化し、重複を排除してください。

いいえ。返されるのはハイライトのコンテナです。コンテナ内の個々のストーリーズのアイテムが必要な場合は、存在する数値の extra.highlight_id を instagram/highlight-items で使用してください。

レコードには、コンテナID、URL、タイトル、所有者ID、ユーザー名と名前、直接公開されているメディア、一般的な公開数値、created_at、collected_at、extra.highlight_id、extra.media_count が含まれる場合があります。

呼び出し側で制御できる results_limit や、プロバイダー側の継続取得は実装されていません。各ユーザー名へのリクエストは1回で、タスクエンドポイントの cursor と limit は保存済みの正規化レコードをページ送りするだけです。

公開プロフィールに保存済みのハイライトがない場合や、アカウントが非公開、利用不可、制限付きの場合があります。タスクが成功して items 配列が空の場合は、結果なしという正常な結果として扱ってください。

保存された正規化ハイライト1件につき0.5クレジットで、基本料金はかかりません。見積もりは送信したユーザー名1つにつき20件で算出し、最終的な使用量は実際に保存されたレコード数に基づきます。