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をポーリングして、正規化されたレコードをカーソルページネーションで読み取ります。
- 空でないテキストクエリを用意し、必要に応じて投稿期間を選びます。results_limit は20〜2,000の範囲で設定します。
- query と、任意の results_limit、published_within フィールドを /v1/instagram/reels-search に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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 になり得るものとして扱ってください。
関連API
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 Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Audio Reels API
- Instagram Highlight Items 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 Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API