Instagram Trending Reels
Instagramトレンドリールは、現在の発見フィードに表示される公開ショート動画で、キャプション、クリエイター情報、メディア、タイムスタンプ、表示中のエンゲージメントシグナルを含みます。これらのスナップショットレコードは、クリエイティブの確認、発見フィードのモニタリング、コンテンツの比較、リールの追加調査に活用できます。
Instagram Trending Reels API の主な機能
- 条件指定なしのフィードスナップショットクエリ、アカウント、ハッシュタグ、地域、日付のフィルターを指定せずに、トレンドフィードに現在表示されているリールを取得します。
- 正規化されたリールのレコードリールの識別情報、公開URL、キャプション、投稿者情報、メディアのメタデータ、タイムスタンプ、表示中のいいね数・コメント数・視聴回数・再生回数を1つの形式で受け取れます。
- 重複の抑制正規化レコードを保存する前に、フィード内で繰り返し現れる行をリールID、プライマリキー、ショートコードでまとめます。
Instagram Trending Reels API のパラメータ
送信できます
このエンドポイントにはリクエストパラメータは不要です。空のJSONオブジェクトをそのまま送信してください。
{}Instagram Trending Reels API の使い方
空のJSONオブジェクトを非同期タスクとして送信し、タスクIDをポーリングして、保存されたスナップショットのレコードを結果カーソルのページネーションで読み取ります。
- 空のJSONオブジェクトを用意します。
- リクエストボディを /v1/instagram/trending-reels に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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 trueInstagram 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 になり得る公開フィールドとして扱ってください。
関連API
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 Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Stories 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