x/
search-users

キーワードで公開Xユーザーアカウントを検索し、正規化されたアカウント情報、プロフィール文、認証ステータス、フォロワー数などのオーディエンス指標を取得します。

Twitter User Search API

ユーザー検索
アカウントの発見
正規化されたプロフィール
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Twitter User Search

X上で関連するクリエイター、企業、専門家のプロフィールを見つけるには、アカウントのハンドルやプロフィール文を対象にしたキーワードの照合が必要です。正規化されたプロフィール結果では、ユーザー名、表示名、プロフィール文、所在地、フォロワー数、認証バッジを取得できます。

Twitter User Search API の主な機能

  • キーワードによるアカウント照合任意の検索語を送信し、名前、ユーザー名、プロフィール文から関連する公開プロフィールを見つけます。
  • 正規化されたプロフィール属性ユーザーID、ハンドル、表示名、アイコン画像、ヘッダー画像、プロフィール文を含む統一形式のオブジェクトを受け取れます。
  • オーディエンス指標返された各アカウントについて、現在のフォロワー数・フォロー数・総ポスト数・メディア数・いいね数を取得します。
  • 認証とステータスのフラグ青い認証バッジ、自動化されたbotのフラグ、非公開アカウントの状態、所在地の文字列を確認できます。

Twitter User Search API のパラメータ

パラメータ必須説明
query必須該当する公開Xユーザープロフィールを見つけるための検索キーワードです。
results_limit任意返すユーザープロフィールの最大数です。20から2,000までの20の倍数である必要があり、デフォルトは20です。

Twitter User Search API の使い方

キーワード検索のクエリを非同期タスクとして送信し、正規化されたユーザープロフィールをページ送りで取得します。

  1. query に検索語を設定し、results_limit を20の倍数(最大2,000)で指定します。
  2. SocQのAPIキーを付けて /v1/x/search-users に POST リクエストを送信します。
  3. タスクの status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items から正規化されたアカウントレコードを取得します。
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Twitter User Search API の主なユースケース

  • インフルエンサーや専門家の発見: 業界用語で検索し、影響力のある分野の専門家、ジャーナリスト、ソートリーダーを見つけます。
  • ブランドアカウントの監査: プラットフォーム全体で、ブランドのハンドル、地域別の現地法人アカウント、非公式のファンアカウントを見つけます。
  • アウトリーチ候補リストの作成: 公開プロフィール文のキーワードで絞り込んだ関連分野の専門家から、見込み客リストを作成します。

Twitter User Search API 活用のヒント

  • このエンドポイントはアカウントの発見に使用します。個々のポストを探す場合は X Search を使用してください。
  • 取得元のページネーション単位に合わせるため、results_limit は20の倍数(例:20、40、100)で指定してください。
  • アカウントが公式に認証されているかどうかは、is_verified と verified_type のプロパティで確認してください。
  • 見つかったユーザー名を X User Posts や X Following List に渡すと、そのオーディエンスのつながりをさらに調べられます。

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

  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • Twitter Search API — 検索式で公開ポストを探します。最新順または話題順の並び替えと、取得件数の上限を指定できます。
  • X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
  • X Trends API — 既知の数値WOEIDについて、現在の公開Xトレンドのスナップショットを取得し、元の順位、クエリ、説明、地域情報を返します。
  • X Communities Search API — キーワードでコミュニティを探し、メンバー数と、メンバー・投稿の取得にそのまま使えるリンクを返します。

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

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

Twitter User Search API — よくある質問

Twitter User Search APIは、テキストクエリを使ってX上の公開ユーザーアカウントやクリエイターのプロフィールを検索するAPIです。フォロワー数、プロフィール文、認証バッジ、アイコン画像のURLを含む正規化プロフィールレコードを返します。

X Search エンドポイントはキーワードに一致する公開ポストを検索するのに対し、Twitter User Search はユーザーアカウントやチャンネルのプロフィールに特化して検索します。

取得元のプロバイダーはユーザー検索の結果を20件ずつの固定ページで提供するため、指定する上限も20の倍数である必要があります。