Twitter Profile Scraper
Xプロフィールは、ユーザー名、表示名、プロフィール文、プロフィールURL、画像、ステータス表示、表示中の各種カウントによって公開アカウントを特定するものです。これらのシグナルを取得時刻とあわせて読み取ることで、アカウントの選定、ディレクトリの情報補完、プロフィールの変化の比較に活用できます。
Twitter Profile Scraper API の主な機能
- ユーザー名からプロフィールを取得1回の取得で1つ以上の公開Xユーザー名を照会できます。各値の先頭に @ が付いていてもいなくてもかまいません。
- アカウント情報、プロフィール文、画像ID、ユーザー名、表示名、プロフィールURL、プロフィール文、所在地、アイコン画像、ヘッダー画像、作成日時からアカウントレコードを構築します。
- アカウントの状態とオーディエンス規模認証、非公開、メッセージ、固定ポスト、自動化アカウントの各シグナルを、フォロワー数・フォロー数・ポスト数・メディア数・いいね数とあわせて取得します。
- 比較可能なプロフィールのスナップショット送信したユーザー名、アカウント作成日、collected_at をまとめて保持するため、繰り返し照会しても時系列で追跡できます。
Twitter Profile Scraper API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
usernames | 必須 | 必須。公開Xユーザー名のリストです。各値の先頭に @ を付けても付けなくてもかまいません。 |
Twitter Profile Scraper API の使い方
まずアカウントリストを用意し、共通の非同期タスクとカーソル方式の結果取得フローで照会します。
- 調べたい公開ユーザー名を正規化します。先頭の @ は任意です。
- usernames 配列を /v1/x/profiles に POST し、返された task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら data.results.items を保存し、has_more が true の間は next_cursor を使って続きを取得します。
curl -X POST "https://api.socq.ai/v1/x/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["nasa","@OpenAI"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTwitter Profile Scraper API の主なユースケース
- クリエイターやパートナーアカウントの審査: 候補リストに加える前に、既知のアカウントリスト全体でアカウント情報、プロフィール文、認証状態、フォロワー数などを比較します。
- アカウントディレクトリの補完: 既存のCRMやパートナーのレコードに、プロフィールURL、表示名、プロフィール文、画像、所在地、公開されている各種カウントを追加します。
- プロフィールの変化の比較: 同じアカウントIDを繰り返し照会し、collected_at を使ってスナップショット間のプロフィール文、ステータスのシグナル、フォロワー数などを比較します。
Twitter Profile Scraper API 活用のヒント
- 大量のアカウントリストを送信する前に、先頭の @ を取り除き、大文字・小文字を区別せずにユーザー名の重複を排除してください。
- id を固定のアカウントキーとして保存し、表示用とソースとの照合用に username と extra.input_username も保持してください。
- フォロワー数、ポスト数、メディア数の比較は、カウントを恒久的な値として扱わず、必ず collected_at を基準にしてください。
- 画像やアカウントのシグナルなど任意の項目は null を許容し、一部しか公開されていないプロフィールでも後続のレコードが壊れないようにしてください。
関連API
Twitter Profile Scraper API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。
- Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
- X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
- X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
- X Post Retweeters API — 既知のXまたはTwitterのステータスURLをリポストしたアカウントについて、正規化された公開プロフィールをタスク単位で重複なく取得します。
- X Account Location API — アカウントの拠点となる国、Xへの接続方法、登録日、ユーザー名の変更回数を確認します。
- Twitter Media Scraper API — アカウントが投稿した画像・動画・GIFのポストを、最高画質のメディアファイルとともに取得します。
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context 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 Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API