instagram/
reels

1つ以上のユーザー名から公開Instagramリールを収集し、正規化されたキャプション、メディア、再生時間、音源、ハッシュタグ、メンション、表示中のエンゲージメントを返します。

Instagram Reels API

リール
公開データ
メディアのメタデータ
結果1件あたり0.52クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Reels

Instagramリールは、キャプション、クリエイター情報、メディア、音源、再生時間、ハッシュタグ、メンション、再生回数、表示中のエンゲージメントを含むショート動画の投稿です。これらのクリエイティブとパフォーマンスのシグナルは、フォーマット調査、クリエイター比較、キャンペーンの振り返り、トレンド分析に活用できます。

Instagram Reels API の主な機能

  • プロフィールのリール収集1つ以上のInstagramユーザー名の公開リールを、正規化された1つのレスポンス形式で収集します。
  • コンテンツ・メディア・エンゲージメントのフィールドキャプション、タイムスタンプ、再生回数、いいね数、コメント数、シェア数、再生時間、サムネイル、動画の参照情報、ハッシュタグ、メンション、音源のメタデータを返します。
  • 取得件数の上限指定results_limit で、リクエストごとに取得するリールの件数に上限を設定できます。
  • 公開データの範囲非公開、制限付き、削除済み、ログインが必要なリールは結果の対象外です。

Instagram Reels API のパラメータ

パラメータ必須説明
usernames必須@ を付けない公開Instagramユーザー名です。カンマまたは改行で区切って指定します。
results_limit任意収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。

Instagram Reels API の使い方

公開ユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、正規化されたリールのレコードをカーソルページネーションで読み取ります。

  1. @ を付けない1つ以上の公開Instagramユーザー名を用意します。
  2. usernames と任意の results_limit を /v1/instagram/reels に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、さらにレコードがある場合は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

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

  • リールのパフォーマンス調査: 公開されている再生回数、いいね数、コメント数、シェア数、キャプション、タイムスタンプを収集し、ショート動画のパフォーマンスを比較します。
  • クリエイターの発掘: 関連するプロフィールの公開リールを確認し、選んだクリエイターの情報をプロフィールや投稿タイムラインのAPIで補完します。
  • キャンペーンのモニタリング: 新商品の発表、ハッシュタグ、音楽トレンド、クリエイター向けブリーフ、定番のコンテンツフォーマットに関連する公開リールを追跡します。
  • メディアアーカイブのワークフロー: 公開リールのメタデータ、サムネイル、ソースURL、再生時間、音源の詳細、収集日時を、レビューやレポーティングのシステムに保存します。
  • 音声分析: 公開されている音声フィールドを利用できる場合は、トピックのクラスタリング、モデレーションの確認、クリエイティブ分析に活用します。

Instagram Reels API 活用のヒント

  • 収集ジョブをリトライ・監査できるよう、固定のリールID、ショートコード、URL、タスクIDを保存してください。
  • 公開プロフィールのリールを大量に収集する場合は、results_limit を控えめに設定し、バックオフのロジックを組み込んでください。
  • ソース側の状況によっては、一部の公開リールでカウンター、動画の参照情報、音源の詳細が欠けることがあります。
  • プロフィールの発見には Search API を、選んだユーザー名の公開リールの取得には Reels API を使用してください。
  • 非公開アカウント、制限付きのリール、ログインが必要なフィールドを前提にしたワークフローは設計しないでください。

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

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

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

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

Instagram Reels API — よくある質問

Instagram Reels APIは、1つ以上のInstagramユーザー名について、公開されているリールを収集するAPIです。正規化されたキャプション、投稿者情報、メディアの参照情報、再生時間、音源、ハッシュタグ、メンション、表示中のエンゲージメント数を返します。

主なフィールドは、リールID、ショートコード、URL、投稿者、キャプション、タイムスタンプ、表示中の指標、メディアの参照情報、再生時間、ハッシュタグ、メンション、音源のメタデータ、収集日時です。

現在のエンドポイントは、1つ以上の公開Instagramユーザー名を受け付けます。個別のリールURLやショートコードはリクエストの入力として使用できません。

いいえ。このエンドポイントは公開されている結果のみを収集するため、非公開、制限付き、削除済み、ログインが必要なリールでは、データが限られるかレコードが返らない場合があります。

公開リールの結果に動画URLが含まれている場合は、公開動画の参照情報を返せます。メタデータやサムネイルしか公開されていないリールもあるため、クライアント側ではメディアフィールドの欠落に対応してください。

リクエストレートを控えめにし、ページサイズを小さくし、カーソルによる継続取得を使い、429 などの負荷を示すレスポンスの後はバックオフを入れてください。1つのプロフィールを大量に繰り返しスクレイピングすることは避けてください。

はい。公開結果に音源データが含まれている場合に返されます。正規化された audio オブジェクトには、ID、タイトル、アーティスト、URLが含まれることがあります。