instagram/
reels-search

テキストクエリで公開Instagramリールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を正規化されたレコードで返します。

Instagram Reels Search API

テキストクエリで探索
リールのレコード
投稿期間の指定
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Reels Search

Instagramリールは、キャプション、クリエイター情報、メディア、投稿日時、ソースの product type、表示中のエンゲージメントを含む公開ショート動画です。これらのコンテンツとパフォーマンスのシグナルは、トピックのモニタリング、クエリ別の調査、クリエイターのマッピング、比較レビューに活用できます。

Instagram Reels Search API の主な機能

  • テキストクエリによるリール探索既知のプロフィール、ハッシュタグ、音源ID、コンテンツURLを起点にせず、意味のある1つの検索フレーズで公開リールを探します。
  • 投稿期間の指定タスクで新しさの範囲を定めたい場合は、探索の対象を過去1時間、1日、1週間、1か月、1年に絞り込めます。
  • コンテンツとクリエイターのレコードリールの識別情報、正規URL、キャプション、投稿者情報、メディアの参照情報、投稿日時、表示中のエンゲージメントを1つの形式で受け取れます。
  • 件数を区切った重複のない収集タスクごとに20〜2,000件の範囲でレコード数を設定でき、固定のリールIDによって重複が排除され、保存された各アイテムには元のクエリが保持されます。

Instagram Reels Search API のパラメータ

パラメータ必須説明
query必須必須。現在の公開Instagramリールの検索対象を検索するための、空でないテキストです。
results_limit任意クエリに対してリクエストするレコードの最大件数です。デフォルトは100で、20〜2,000の整数を指定できます。
published_within任意任意。投稿期間を hour、day、week、month、year のいずれかで指定します。

Instagram Reels Search API の使い方

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

  1. 空でないテキストクエリを用意し、必要に応じて投稿期間を選びます。results_limit は20〜2,000の範囲で設定します。
  2. query と、任意の results_limit、published_within フィールドを /v1/instagram/reels-search に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 から data.results.items を読み取り、results.has_more が true の間は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/reels-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$INSTAGRAM_REELS_QUERY\",\"results_limit\":20,\"published_within\":\"week\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items and follow results.next_cursor.

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

  • クエリ別のリールデータセット: リールID、URL、キャプション、メディア、投稿者、extra.search_query を組み合わせ、1つのトピックについて追跡可能なデータセットを作成します。
  • 最新トピックのモニタリング: 投稿期間と created_at、表示中のエンゲージメントを使い、定期的に実行するクエリで最近表示されたリールを確認します。
  • トピック内のクリエイター発掘: 正規化された投稿者ID、ユーザー名、名前、アバターを使い、該当するリールに登場するクリエイターをマッピングします。
  • コンテンツフォーマットの比較: 同じクエリで返されたリールについて、キャプション、メディアのメタデータ、ソースの product type、表示中の指標を比較します。

Instagram Reels Search API 活用のヒント

  • 入力の前後の空白を除去した後も意味のある検索語でタスクが開始されるよう、空白だけではない、絞り込んだクエリフレーズを使ってください。
  • 現在の公開検索結果は変化することがあるため、定期実行の結果を比較する場合は query、published_within、results_limit をそろえてください。
  • 結果ページや複数のタスクを結合する場合は、クエリの取得元と重複排除を明確にするため、extra.search_query と固定のリールIDを保持してください。
  • 下流のコードでは、キャプション、クリエイターのフィールド、メディア、タイムスタンプ、product type、表示中のカウンターを null になり得るものとして扱ってください。

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

  • Instagram Search API — キーワードまたはハンドル名で公開プロフィールを検索し、アカウント情報と表示中のアカウントシグナルを返します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Hashtag Posts API — ハッシュタグで公開投稿を探し、元のタグ情報、メディア、クリエイター、タイムスタンプ、表示中のエンゲージメントを返します。
  • Instagram Transcript API — 公開投稿またはリールのURLから、文字起こしテキスト、言語、形式、元のURL、ショートコードを抽出します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。
  • Instagram Location Info API — IDまたはロケーションページのURLから1つのロケーションを照会し、名称、カテゴリ、電話番号、座標、タグ付けされた投稿数を返します。

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

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

Instagram Reels Search API — よくある質問

Instagram Reels Search APIは、送信したテキストクエリから公開Instagramリールを探すためのプログラムインターフェースです。正規化されたリールの識別情報、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。

query は必須で、空白以外の文字を含む必要があります。results_limit は20〜2,000を受け付け、デフォルトは100です。published_within は hour、day、week、month、year を受け付けます。

結果には、リールIDとURL、キャプション、投稿者情報、いいね数・コメント数・視聴回数・再生回数、メディアの参照情報、created_at、collected_at、extra.search_query、ソースの product type が含まれる場合があります。

results_limit は上限値であり、件数を保証するものではありません。取得できる公開検索結果は実行ごとに変わることがあり、同じ固定IDを持つ重複したリールはタスク内で除去されます。

保存された正規化結果1件につき0.5クレジットで、タスクの基本料金はかかりません。初期の見積もりは results_limit(未指定時はデフォルトの100)で算出され、最終的な使用量は実際に保存されたレコード数に基づきます。保存されたレコードがないタスクでは、結果に対する課金は発生しません。