instagram/
search

キーワードやハンドルで公開Instagramプロフィールを検索し、正規化されたアカウント情報、プロフィール文、プロフィール画像、認証・非公開の状態、表示中のアカウント数値を返します。

Instagram Search API

プロフィール検索
アカウント発見
公開データ
結果1件あたり0.54クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Search

Instagramの検索結果は、名前、キーワード、トピックに一致した公開プロフィールで、ユーザー名、プロフィール文、プロフィール画像、認証・非公開の状態、表示中のアカウント指標を含みます。これらのレコードは、クリエイターの発掘、ブランド調査、オーディエンスの選別、プロフィール情報の補完に活用できます。

Instagram Search API の主な機能

  • プロフィールのキーワード検索キーワード、ハンドル、名前、アカウントに関するフレーズで公開Instagramプロフィールを検索します。
  • アカウント情報と数値各プロフィール結果について、ユーザー名、表示名、プロフィール文、プロフィールURL、アバター、認証・非公開の状態、表示中の数値フィールドを返します。
  • 一貫したプロフィールスキーマ幅広いキーワード、名前、ハンドルの完全一致のいずれで検索しても、同じ形式の正規化プロフィールを返します。
  • 取得件数の上限指定results_limit で、1回の検索でリクエストするプロフィールレコードの最大件数を設定できます。
  • 公開データの範囲非公開、制限付き、削除済み、ログインが必要なプロフィールデータはレスポンスの対象外です。

Instagram Search API のパラメータ

パラメータ必須説明
query必須検索キーワード、ハンドル、またはプロフィールに関するフレーズです。
results_limit任意収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。

Instagram Search API の使い方

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

  1. 空でないプロフィールのキーワード、ハンドル、または検索フレーズを用意します。
  2. query と任意の results_limit を /v1/instagram/search に 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/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"sustainable travel","results_limit":25}'

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

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

  • クリエイターの発掘: 詳細な情報補完の前に、キーワード、ハンドル、カテゴリ、キャンペーンのフレーズに関連する公開プロフィールを見つけます。
  • アカウント情報の補完: 選んだ検索結果について、公開プロフィールのアカウント情報、プロフィール文、認証・非公開の状態、表示中の数値フィールドを取得します。
  • ブランドの発見: 名前、商品カテゴリ、市場に関するフレーズに関連する、ブランドや組織の公開プロフィールを見つけます。
  • 調査用リストの作成: 調査、アプローチ先の選定、社内分析のために、確認可能な公開Instagramプロフィールのリストを作成します。
  • プロフィール選定ワークフロー: 関連するプロフィールを選んだうえで、Posts、Reels、Followers Count の各APIを呼び出し、より詳しい公開レコードを取得します。

Instagram Search API 活用のヒント

  • 検索ワークフローでは 429 レスポンスを通常の負荷シグナルとして扱い、積極的にリトライするのではなく、バックオフと取得件数の縮小で対応してください。
  • 検索を再実行・監査できるよう、タスクID、固定のプロフィールID、ユーザー名、正規URLを保存してください。
  • 検索結果はプロフィールの発見に使い、より詳しいレコードが必要な場合は Posts、Reels、Followers Count の各APIを呼び出してください。
  • 公開されているAPIドキュメントで明示的にサポートされていない限り、非公開データ、ログインが必要なデータ、アカウント所有者のみが見られるデータを連携の前提に含めないでください。
  • ユーザーが入力した検索語は、本番パイプラインに送る前にサニタイズしてください。

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

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Hashtag Posts API — ハッシュタグで公開投稿を探し、元のタグ情報、メディア、クリエイター、タイムスタンプ、表示中のエンゲージメントを返します。
  • Instagram Reels Search API — テキストクエリで公開リールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。
  • Instagram Location Info API — IDまたはロケーションページのURLから1つのロケーションを照会し、名称、カテゴリ、電話番号、座標、タグ付けされた投稿数を返します。

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

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

Instagram Search API — よくある質問

Instagram Search APIは、キーワードやハンドルから公開Instagramプロフィールを検索するAPIです。正規化されたアカウント情報、プロフィール文、プロフィール画像、認証・非公開のシグナル、表示中のアカウント数値を返します。

query では、キーワード、ハンドル、名前、アカウントに関するフレーズで公開プロフィールの結果を検索します。結果を絞り込みたい場合は、具体的なハンドルを指定してください。

現在のエンドポイントは、公開ユーザー・プロフィールの結果のみを検索します。投稿、リール、ストーリーズ、ハッシュタグのレコードは返しません。

主なフィールドは、プロフィールID、ユーザー名、表示名、正規URL、アバター、プロフィール文、認証・非公開の状態、表示中のフォロワー数・フォロー数・投稿数、収集日時です。

results_limit は、リクエストするプロフィールレコードの最大件数を設定します。検索順位や公開状況によって結果が少なくなることがあるため、件数を保証するものではなく上限値です。

検索順位、ハンドルの変更、非公開または削除されたプロフィール、公開結果の一時的な取得状況などにより、返される結果が減ったり変わったりすることがあります。より具体的なクエリを試し、任意のプロフィールフィールドは null になり得るものとして扱ってください。

公開コンテンツのレコードや最新の数値が必要な場合は、返されたユーザー名を Instagram Posts、Reels、Followers Count の各APIで使用してください。