instagram/
trending-reels

条件を指定せずに、トレンドフィードに現在表示されているリールを収集し、キャプション、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

Instagram Trending Reels API

条件の入力不要
現在のフィードのスナップショット
正規化されたリールのレコード
結果1件あたり0.5クレジット
準備完了
README

SocQ 編集 · 更新

Instagram Trending Reels

Instagramトレンドリールは、現在の発見フィードに表示される公開ショート動画で、キャプション、クリエイター情報、メディア、タイムスタンプ、表示中のエンゲージメントシグナルを含みます。これらのスナップショットレコードは、クリエイティブの確認、発見フィードのモニタリング、コンテンツの比較、リールの追加調査に活用できます。

Instagram Trending Reels API の主な機能

  • 条件指定なしのフィードスナップショットクエリ、アカウント、ハッシュタグ、地域、日付のフィルターを指定せずに、トレンドフィードに現在表示されているリールを取得します。
  • 正規化されたリールのレコードリールの識別情報、公開URL、キャプション、投稿者情報、メディアのメタデータ、タイムスタンプ、表示中のいいね数・コメント数・視聴回数・再生回数を1つの形式で受け取れます。
  • 重複の抑制正規化レコードを保存する前に、フィード内で繰り返し現れる行をリールID、プライマリキー、ショートコードでまとめます。

Instagram Trending Reels API のパラメータ

送信できます

このエンドポイントにはリクエストパラメータは不要です。空のJSONオブジェクトをそのまま送信してください。

{}

Instagram Trending Reels API の使い方

空のJSONオブジェクトを非同期タスクとして送信し、タスクIDをポーリングして、保存されたスナップショットのレコードを結果カーソルのページネーションで読み取ります。

  1. 空のJSONオブジェクトを用意します。
  2. リクエストボディを /v1/instagram/trending-reels に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/trending-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Instagram Trending Reels API の主なユースケース

  • 現在の発見フィードの一覧: リールID、公開URL、キャプション、クリエイター情報、収集日時を、現在のフィードのスナップショットとして確認可能な記録に保存します。
  • ショート動画のクリエイティブ確認: キャプションのテキスト、投稿者情報、サムネイル、動画の参照情報、サイズ、再生時間を確認し、1つのスナップショットに含まれるクリエイティブ事例を検討します。
  • スナップショット内のエンゲージメント比較: 同じ収集タスクで返されたリール間で、表示中のいいね数、コメント数、視聴回数、再生回数、作成日時を比較します。

Instagram Trending Reels API 活用のヒント

  • 空のオブジェクトのみを送信してください。query、region、username、hashtag、date、results_limit のフィールドは拒否されます。
  • 各レスポンスは、公式のランキング算出方法や、全世界・地域単位の網羅性を示すものではなく、収集時点でソースが定めたフィードのスナップショットとして扱ってください。
  • アップストリームの次のページはリクエストしないでください。results.next_cursor は、完了したタスクで保存済みのレコードの続きを読み取るためだけのものです。
  • 重複の抑制は各フィードレスポンス内で適用されるため、繰り返し取得したスナップショットを保持する場合は、固定のリールIDまたはURLでタスクをまたいで重複を排除してください。
  • このエンドポイントは過去のスナップショットやスケジュール実行を提供しないため、独自の時系列データを構築する場合は各結果とあわせて collected_at を保存してください。
  • キャプション、投稿者のフィールド、カウンター、メディア、URL、作成日時は、null になり得る公開フィールドとして扱ってください。

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

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
  • Instagram Transcript API — 公開投稿またはリールのURLから、文字起こしテキスト、言語、形式、元のURL、ショートコードを抽出します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。

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

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

Instagram Trending Reels API — よくある質問

Instagram Trending Reels APIは、条件を入力せずに、トレンドフィードに現在表示されている公開リールを収集するためのプログラムインターフェースです。正規化されたリールの識別情報、キャプション、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

入力内容は空のJSONオブジェクトです。query、region、username、hashtag、date、results_limit のフィールドは使用できません。

「トレンド」とは、収集時点で設定済みの発見フィードから返された現在のリールの集合を指します。このエンドポイントはランキングの算出方法を公開しておらず、全世界の網羅性、地域ごとのパーソナライズ、順序の安定性をうたうものではありません。

正規化されたレコードには、リールIDとURL、キャプションのテキスト、投稿者ID、ユーザー名、名前とアバター、表示中のいいね数・コメント数・視聴回数・再生回数、メディアのメタデータ、created_at、collected_at、product type が含まれる場合があります。

results_limit やアップストリームの継続取得パラメータは使用できず、コレクターはフィードへのリクエストを1回だけ行います。ただし、タスク結果のエンドポイントでは、limit と results.next_cursor を使って保存済みのレコードをページ送りで取得できます。

いいえ。各タスクは収集時点で表示されているフィードを取得します。個別に収集したスナップショット同士を比較する必要がある場合は、結果を collected_at とあわせて保持してください。

返された正規化レコード1件につき0.5クレジットで、基本料金はかかりません。送信時は20レコードで見積もり、最終的な使用量は実際に返されたレコード数に基づきます。