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 の使い方
キーワード検索のクエリを非同期タスクとして送信し、正規化されたユーザープロフィールをページ送りで取得します。
- query に検索語を設定し、results_limit を20の倍数(最大2,000)で指定します。
- SocQのAPIキーを付けて /v1/x/search-users に POST リクエストを送信します。
- タスクの status が succeeded になるまで /v1/tasks/{task_id} をポーリングします。
- 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 に渡すと、そのオーディエンスのつながりをさらに調べられます。
関連API
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 — キーワードでコミュニティを探し、メンバー数と、メンバー・投稿の取得にそのまま使えるリンクを返します。
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API