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つ以上の既知のInstagram音源IDを、空でない数字の文字列として用意します。
- audio_ids と、音源ごとの任意の results_limit を /v1/instagram/audio-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/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 trueInstagram Audio Reels API の主なユースケース
- 音源の利用状況の確認: 公開リールのURL、キャプション、クリエイター、タイムスタンプを extra.audio_id ごとにまとめ、既知の音源に関する表示中の利用状況を確認します。
- クリエイティブ事例の調査: 選んだ音源IDに関連するキャプション、クリエイター情報、メディアの参照情報、元のリールURLから、取得元に紐づいた確認用データセットを作成します。
- 表示中のエンゲージメントの比較: 各レコードを生成した音源IDを保持したまま、収集したリール全体で取得可能ないいね数、コメント数、視聴回数、再生回数を比較します。
Instagram Audio Reels API 活用のヒント
- このエンドポイントは数値の識別子を受け付けるもので、曲名、アーティスト、キーワードで音源を検索することはできないため、送信前に音源IDを特定・確認してください。
- results_limit は送信した識別子ごとに個別に適用されるため、取得量と見積もりクレジットは音源IDごとに計画してください。
- 繰り返し収集したデータを統合する場合は、固定のリールIDまたは正規URLで重複を排除し、取得元の特定のために extra.audio_id は保持してください。
- カウンター、メディア、クリエイターのフィールド、タイムスタンプは任意項目として扱ってください。また、収集結果は過去の完全なアーカイブではなく、音源ごとの上限、フィードの終端、100ページの上限によって区切られたものと考えてください。
関連API
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 Followers Count API
- Instagram Search API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Highlight Items API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels 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