XTwitterXリストXコミュニティXスペースAPIガイド

X API 新エンドポイント:リスト、コミュニティ、スペース、記事、アカウントの所在地を取得

SocQのX(Twitter)に14の新エンドポイントが加わりました。アカウントの所在地、認証済みフォロワー、フォロー関係の確認、リスト、コミュニティ、メディアと返信、記事、スペース、動画の文字起こしに対応します。

SocQ2026年11月19日更新約10分で読めます

SocQのXエンドポイントは、これまでも公開プロフィール、投稿、タイムライン、検索、返信、引用、フォロワー、トレンドを返してきました。これらはX/Twitterデータ収集ガイドで解説しています。2026-11-17には、さらに14のエンドポイントがXのプラットフォームページで公開されました。基本のエンドポイントでは届かなかった領域、つまり「このアカウントについて」パネル、リスト、コミュニティのメンバーとモデレーター、ユーザーのメディアタブと返信タブ、長文の記事(Articles)、スペース、動画内の音声をカバーします。

このガイドでは、新しいエンドポイントを用途ごとにまとめ、それぞれのリクエスト例と料金を紹介します。

結論: POST https://api.socq.ai/v1/x/<endpoint> にJSONボディを送信します。返された task_id を保存し、status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングしてから、data.results.items を読み取ります。14のエンドポイントはすべて結果1件あたり0.7クレジット($0.0035)です。例外は、Video Transcriptで長い動画を処理する場合だけです。

新しいXエンドポイントの一覧

1 SocQクレジット = $0.005です。基本料金はないため、結果が空の場合は費用がかかりません。

エンドポイント返す内容料金
X Account Location APIアカウントの拠点国、Xへの接続方法、登録日、ユーザー名の変更履歴アカウント1件あたり0.7クレジット($0.0035)
X Verified Followers APIプロフィールをフォローしている認証済みアカウントフォロワー1件あたり0.7クレジット($0.0035)
Twitter Follow Checker API最大100ペアについて、フォロー中・フォローされている・相互フォローのフラグ1ペアあたり0.7クレジット($0.0035)
X List Tweets APIリストのタイムライン(新しい順)。リポストにはフラグ付き投稿1件あたり0.7クレジット($0.0035)
Twitter List Members APIリストに登録されたアカウントを完全なプロフィールとしてメンバー1件あたり0.7クレジット($0.0035)
Twitter List Followers APIリストをフォローしているアカウントを完全なプロフィールとしてフォロワー1件あたり0.7クレジット($0.0035)
X Communities Search APIキーワードに一致するコミュニティと、そのメンバー数とURLコミュニティ1件あたり0.7クレジット($0.0035)
X Community Members APIコミュニティのメンバーを完全なプロフィールとしてメンバー1件あたり0.7クレジット($0.0035)
X Community Moderators APIコミュニティの管理者とモデレーターモデレーター1件あたり0.7クレジット($0.0035)
Twitter Media Scraper APIアカウントのメディアタブの投稿と、元の画質のファイル投稿1件あたり0.7クレジット($0.0035)
X User Replies APIアカウントが書いた返信と、それぞれの返信先の投稿返信1件あたり0.7クレジット($0.0035)
X Articles API記事のタイトル、プレビュー行、本文全体、カバー画像、エンゲージメント記事1件あたり0.7クレジット($0.0035)
X Spaces APIスペースのステータス、予定日時、ホスト、スピーカー、リスナー、録音の再生スペース1件あたり0.7クレジット($0.0035)
Twitter Video Transcript API投稿の動画で話されている内容のテキストと、動画の長さ2分以内の動画1本あたり0.7クレジット($0.0035)

認証と非同期タスクの流れ

すべてのリクエストはAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれにも同じヘッダーを使います。

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

収集処理はすべてバックグラウンドのタスクとして実行されます。

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

送信のリクエストは、data.task_id と data.status をすぐに返します。そのIDでタスクをポーリングします。

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status が succeeded になると、レスポンスには result_count、credits_amount、そして data.results.items に正規化されたレコードの最初のページが含まれます。limit のデフォルトは50で、最大500まで指定できます。results.has_more がtrueの場合は、results.next_cursor を cursor として渡すと次のページを読み取れます。失敗したタスクには error_message が含まれます。

以下のエンドポイントはすべて、任意の callback_url も受け付けます。タスクが完了すると、SocQはタスクの概要を1回POSTで送信します。レコードはタスクのエンドポイントから読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、再送信せずに同じタスクIDで再開してください。402 はアカウントのクレジット不足、429 はキーがレート制限またはクレジットの上限に達したことを意味します。

results_limit についての注意: Verified Followers、リストとコミュニティのメンバー系エンドポイントでは、入力ごとに適用され、デフォルトは100で、20から2000までの20の倍数で指定する必要があります。Communities Searchでは、10から500までの10の倍数で指定します。

アカウントと関係性を確認する

Account Location は「このアカウントについて」パネルを読み取り、country、connected_via(例:United States App Store や Web)、登録日、username_changes_count、affiliate_username を返します。インフルエンサーの審査や、組織的に連携したアカウントの発見に使えます。多くの政府機関のアカウントなど、国が表示されないアカウントもありますが、その場合も country: null の行が返されます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/user-about" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["elonmusk", "BBCWorld"]}'

Verified Followers は、Xの「認証済みフォロワー」タブに表示される一覧を返します。各行は認証済みのフォロワー(actor)で、問い合わせたアカウント(related_actor)に紐づきます。オーディエンスのうち影響力のある層の規模を測ったり、競合のフォロワーからアウトリーチ用のリストを作ったりするのに使えます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["NASA"], "results_limit": 20}'

Follow Checker は、1つの username を最大100件の usernames と比較します。各ペアについて is_following、is_followed_by、is_mutual を返します。キャンペーンの参加者が自社ブランドをフォローしているかの確認に使えます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}'

Xのリストを読み取る

3つのエンドポイントはいずれも、/i/lists/{numeric_id} 形式の公開リストURLを受け付けます。

List Tweets は、リストのタイムラインを新しい順に返します。リポストも含まれ、is_repost に加えて reposted_post_id と reposted_author が付くため、必要に応じて除外できます。1回のリクエストで、ニッチな分野全体をモニタリングできます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/list-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Members は、リストに登録されたアカウントを、自己紹介、所在地、Webサイト、認証の有無、フォロワー数・フォロー数・投稿数を含む完全なプロフィールとしてエクスポートします。人の手で選ばれたリストは、そのまま見込み顧客開拓の出発点になります。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

List Followers は、リストを購読しているアカウントを同じプロフィール形式で返します。リストをフォローすることは、そのトピックへの関心を表明することでもあるため、精度の高いリサーチ用のセグメントになります。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/list-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'

Xのコミュニティを把握する

Communities Search は、キーワードでコミュニティを検索し、名前、メンバー数、バナー、is_nsfw、コミュニティのURLを返します。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/search-communities" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "bitcoin", "results_limit": 20}'

コミュニティのURL(/i/communities/{numeric_id})を Community Members に渡すと、そのメンバーが完全なプロフィールとして返されます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/community-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'

Community Moderators は、管理者を含む運営チーム全体を1回のリクエストで返します。スポンサーシップやAMAを打診する際の連絡先になります。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'

コミュニティの説明とルールはコミュニティ詳細ガイドで、コミュニティの投稿はコミュニティ投稿ガイドで解説しています。

アカウントのメディアと返信を収集する

どちらも1つの username を受け付けます。results_limit のデフォルトは20で、1から1000まで指定できます。

Media Scraper は、アカウントのメディアタブにある投稿を新しい順に、テキスト、エンゲージメント、表示回数、メディアファイルとあわせて返します。動画は、取得できる最高画質のMP4を指します。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/user-media" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "NASA", "results_limit": 20}'

User Replies は、アカウントの返信タブを新しい順に返します。各返信には、返信先の投稿のテキスト、投稿者、リンク、日時を含む in_reply_to が付くため、1行ごとにやり取り全体を読み取れます。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username": "elonmusk", "results_limit": 20}'

会話全体を取得する場合は、スレッドの文脈ガイドを参照してください。

記事、スペース、動画の音声を読み取る

Articles は、記事を公開している投稿のURL(/{username}/status/{post_id})を受け付け、title、summary としてのプレビュー行、text に入った本文全体、カバー画像、投稿者、いいね数・返信数・引用数・表示回数を返します。記事ではない投稿は行を返しません。URLのどれも記事でない場合、タスクは失敗となり、課金されません。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/article" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'

Spaces は、/i/spaces/{space_id} 形式のリンクを受け付けます。各スペースについて、タイトル、status(予定、ライブ配信中、終了)、scheduled_start_at、ホスト、スピーカー、ライブのリスナー数、録音の再生回数、is_replay_available を返します。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/space" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'

Video Transcript は、投稿の動画で話されている内容をプレーンテキストに変換し、duration_seconds とあわせて返します。2分以内の動画は0.7クレジットです。それより長い動画は、全体の長さについて開始した1分ごとに4クレジット($0.02)かかるため、3分の動画は12クレジット($0.06)になります。動画のない投稿は行を返さず、課金されません。(ドキュメント)

curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'

Xの関連ガイド

SocQをほかのXデータプロバイダーや公式APIと比較するには、Twitter APIの料金とおすすめのX API代替サービス、おすすめのTwitter/XスクレイパーAPI 7選、TwitterAPI.ioの代替サービスをご覧ください。

よくある質問(FAQ)

Xに国が表示されていない場合、X Account Location APIは何を返しますか?

country が null の行を返します。connected_via や登録日などのほかのフィールドは、通常どおり返されます。

results_limit が20の倍数でなければならないのはなぜですか?

これはVerified Followers、List Tweets、List Members、List Followers、Community Membersのルールで、入力ごとに20から2000まで、20刻みで指定します。Communities Searchは10から500まで、10刻みです。

記事ではない投稿や、動画のない投稿にも課金されますか?

いいえ。そうした投稿は行を返さず、課金されるのは返された行だけです。Articles APIに送信したURLのどれも記事でない場合、タスクは失敗となり、課金されません。

長い動画の文字起こしにはいくらかかりますか?

2分以内なら0.7クレジットです。それより長い場合は、全体の長さについて開始した1分ごとに4クレジットかかるため、3分なら12クレジット、5分なら20クレジット($0.10)です。

多数のフォロー関係をまとめて確認できますか?

はい。Follow Checkerは、1回のリクエストで1つのアカウントを最大100件のアカウントと比較でき、1ペアあたり0.7クレジットで課金されます。

X API

公開XのURLでワークフローを試す

公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。

XのAPIを見る