x/
profiles

1つ以上の公開Xユーザー名から、アカウント情報、プロフィール文、画像、アカウントの状態、表示中のフォロワー数などの数値、取得時刻を含むプロフィールレコードを取得します。

Twitter Profile Scraper API

アカウント情報
フォロワー数などの数値
アカウントのスナップショット
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

まずアカウントリストを用意し、共通の非同期タスクとカーソル方式の結果取得フローで照会します。

  1. 調べたい公開ユーザー名を正規化します。先頭の @ は任意です。
  2. usernames 配列を /v1/x/profiles に POST し、返された task_id を保存します。
  3. タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら 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 true

Twitter Profile Scraper API の主なユースケース

  • クリエイターやパートナーアカウントの審査: 候補リストに加える前に、既知のアカウントリスト全体でアカウント情報、プロフィール文、認証状態、フォロワー数などを比較します。
  • アカウントディレクトリの補完: 既存のCRMやパートナーのレコードに、プロフィールURL、表示名、プロフィール文、画像、所在地、公開されている各種カウントを追加します。
  • プロフィールの変化の比較: 同じアカウントIDを繰り返し照会し、collected_at を使ってスナップショット間のプロフィール文、ステータスのシグナル、フォロワー数などを比較します。

Twitter Profile Scraper API 活用のヒント

  • 大量のアカウントリストを送信する前に、先頭の @ を取り除き、大文字・小文字を区別せずにユーザー名の重複を排除してください。
  • id を固定のアカウントキーとして保存し、表示用とソースとの照合用に username と extra.input_username も保持してください。
  • フォロワー数、ポスト数、メディア数の比較は、カウントを恒久的な値として扱わず、必ず collected_at を基準にしてください。
  • 画像やアカウントのシグナルなど任意の項目は null を許容し、一部しか公開されていないプロフィールでも後続のレコードが壊れないようにしてください。

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のポストを、最高画質のメディアファイルとともに取得します。

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

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

Twitter Profile Scraper API — よくある質問

Twitter Profile Scraper APIは、1つ以上のユーザー名から公開Xプロフィールのレコードを取得するAPIです。アカウント情報、プロフィール文、画像、ステータスのシグナル、表示中のフォロワー数などの数値、取得時刻を返します。

usernames 配列に1つ以上の公開ハンドルを指定します。nasa と @nasa のどちらも受け付け、重複する値は取得前に正規化されます。

レコードには、アカウントID、ユーザー名、表示名、プロフィールURL、プロフィール文、所在地、アイコン画像、ヘッダー画像、アカウントの状態、作成日時、公開されている各種カウントが含まれる場合があります。

collected_at の時点で観測された公開値として扱ってください。時系列で変化を比較する場合は、同じ id のレコードを繰り返し保存してください。

結果が得られるかどうかは、取得時にそのユーザー名が有効で公開アクセス可能かどうかによります。名前が変更された、非公開、凍結、制限中、または利用できないアカウントでは、有効なレコードが返らないことがあります。

返された正規化プロフィール結果1件につき0.6 SocQクレジットです。