instagram/
audio-reels

既知の数値の音源IDに関連する公開Instagramリールを収集し、キャプション、クリエイター情報、メディア、表示中のエンゲージメント、タイムスタンプ、取得元の音源情報を返します。

Instagram Audio Reels API

音源IDで検索
公開リールのレコード
音源ごとの件数上限
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Audio Reels

Instagram音源リールは、共通の音源IDに関連付けられた公開ショート動画で、キャプション、クリエイター情報、メディアの参照情報、タイムスタンプ、表示中のエンゲージメントを含みます。取得元に紐づいたこれらのレコードは、音源の利用状況の確認、クリエイティブ調査、音源IDごとの公開リールの動向比較に活用できます。

Instagram Audio Reels API の主な機能

  • 既知の音源IDを指定曲名やアーティストで検索するのではなく、1つ以上の数値のInstagram音源IDを送信し、その識別子に正確に関連する公開リールを収集します。
  • 音源ごとの独立した収集各音源IDを、それぞれの results_limit、カーソルの連続取得、入力内でのレコード重複排除によって個別に処理し、取得元ごとに件数を区切って収集します。
  • 取得元に紐づくリールのレコード正規化されたリールID、URL、キャプション、クリエイター情報、メディア、タイムスタンプ、表示中のエンゲージメント、取得元を示す extra.audio_id を受け取れます。

Instagram Audio Reels API のパラメータ

パラメータ必須説明
audio_ids必須1つ以上の既知のInstagram音源IDです。空でない数字の文字列で、カンマまたは改行で区切って指定します。
results_limit任意音源IDごとにリクエストするレコードの最大件数です。デフォルトは100で、20〜2,000の整数を指定できます。

Instagram Audio Reels API の使い方

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

  1. 1つ以上の既知のInstagram音源IDを、空でない数字の文字列として用意します。
  2. audio_ids と、音源ごとの任意の results_limit を /v1/instagram/audio-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/audio-reels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"audio_ids":["123456789012345"],"results_limit":20}'

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

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

  • 音源の利用状況の確認: 公開リールのURL、キャプション、クリエイター、タイムスタンプを extra.audio_id ごとにまとめ、既知の音源に関する表示中の利用状況を確認します。
  • クリエイティブ事例の調査: 選んだ音源IDに関連するキャプション、クリエイター情報、メディアの参照情報、元のリールURLから、取得元に紐づいた確認用データセットを作成します。
  • 表示中のエンゲージメントの比較: 各レコードを生成した音源IDを保持したまま、収集したリール全体で取得可能ないいね数、コメント数、視聴回数、再生回数を比較します。

Instagram Audio Reels API 活用のヒント

  • このエンドポイントは数値の識別子を受け付けるもので、曲名、アーティスト、キーワードで音源を検索することはできないため、送信前に音源IDを特定・確認してください。
  • results_limit は送信した識別子ごとに個別に適用されるため、取得量と見積もりクレジットは音源IDごとに計画してください。
  • 繰り返し収集したデータを統合する場合は、固定のリールIDまたは正規URLで重複を排除し、取得元の特定のために extra.audio_id は保持してください。
  • カウンター、メディア、クリエイターのフィールド、タイムスタンプは任意項目として扱ってください。また、収集結果は過去の完全なアーカイブではなく、音源ごとの上限、フィードの終端、100ページの上限によって区切られたものと考えてください。

Instagram Audio 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 Audio Reels API — よくある質問

Instagram Audio Reels APIは、送信した数値の音源IDに関連する公開Instagramリールを収集するためのプログラムインターフェースです。正規化されたリールの識別情報、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、取得元の音源情報を返します。

既知のInstagram音源IDを表す数字の文字列を、空でない配列で送信してください。このエンドポイントは、曲名、アーティスト名、キーワードをIDに変換しません。

results_limit は20〜2,000の整数を受け付け、デフォルトは100です。音源IDごとに個別に適用され、各取得元の収集はフィードの終端または100ページの上限に達した時点でも終了します。

レコードには、リールID、URL、キャプションのテキスト、クリエイターID、ユーザー名、名前、アバター、メディアの参照情報、created_at、collected_at、表示中のいいね数・コメント数・視聴回数・再生回数に加え、extra.audio_id が含まれる場合があります。

いいえ。結果は、音源ごとにリクエストした件数、ソースから返される公開フィード、100ページの収集上限によって制限されます。また、取得できない公開フィールドは null のままか、含まれない場合があります。

返された正規化レコード1件につき0.5クレジットで、基本料金はかかりません。見積もりは音源ごとの results_limit に送信した音源IDの数を掛けて算出し、最終的な使用量は実際に保存されたレコード数に基づきます。