X公開データAPI
公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。
利用できるX API
ユーザー名、ポストのURL、アカウントリスト、検索クエリ、既知の数値WOEIDなど、手元にある情報に合ったAPIを選べます。

x/profiles
プロフィール結果1件あたり0.6クレジット

x/followers-list
プロフィール結果1件あたり0.5クレジット

x/posts
投稿結果1件あたり0.5クレジット

x/post-retweeters
プロフィール結果1件あたり0.5クレジット

x/user-posts
投稿結果1件あたり0.5クレジット

x/search
検索結果1件あたり0.7クレジット

x/following-list
プロフィール結果1件あたり0.5クレジット

x/post-quotes
投稿結果1件あたり0.5クレジット

x/post-replies
コメント結果1件あたり0.5クレジット

x/trends
検索結果1件あたり0.5クレジット

x/mentions
投稿結果1件あたり0.7クレジット

x/search-users
検索結果1件あたり0.6クレジット

x/community
プロフィール結果1件あたり0.5クレジット

x/community-posts
投稿結果1件あたり0.7クレジット

x/thread-context
投稿結果1件あたり0.5クレジット

x/user-about
プロフィール結果1件あたり0.7クレジット

x/verified-followers
プロフィール結果1件あたり0.7クレジット

x/list-posts
投稿結果1件あたり0.7クレジット

x/list-members
プロフィール結果1件あたり0.7クレジット

x/list-followers
プロフィール結果1件あたり0.7クレジット

x/community-members
プロフィール結果1件あたり0.7クレジット

x/community-moderators
プロフィール結果1件あたり0.7クレジット

x/search-communities
検索結果1件あたり0.7クレジット

x/article
投稿結果1件あたり0.7クレジット

x/space
投稿結果1件あたり0.7クレジット

x/user-media
投稿結果1件あたり0.7クレジット

x/user-replies
コメント結果1件あたり0.7クレジット

x/check-follow
プロフィール結果1件あたり0.7クレジット

x/post-transcript
投稿結果1件あたり0.7クレジット
取得できるXデータ
アカウント情報、既知のコンテンツ、最近の投稿アクティビティ、ポストの検索、地域ごとの現在のトピックを軸にデータセットを構築できます。
公開アカウントのプロフィール
ユーザー名から、アカウント情報、プロフィール文、画像、アカウントのステータス、オーディエンス指標、フォロワーリスト、フォロー中リスト、取得日時を取得します。
既知のポストの詳細
公開ステータスURLから、ポストの詳細、返信、引用ポスト、リツイートしたユーザーのプロフィール、メディア、関係、表示中のエンゲージメントを取得します。
アカウントごとの最近のポスト
指定したユーザー名の最近の公開ポスト(返信を除く)を取得し、アカウントリスト全体のアクティビティを比較します。
ポストの検索と発見
1つのクエリで公開ポストを検索し、最新順または人気順を選べます。一致したすべてのポストにクエリが紐づけられます。
WOEID別の現在のトレンド
地域ごとのトレンド名、取得元での順位、クエリ、説明、観測日時のスナップショットを取得します。
SocQとXの開発者向けプロダクト
SocQは、一貫した公開データ調査のワークフロー向けに構築されています。Xの開発者向けプロダクトは、X独自のプロダクトと認可要件のもとで、Xが管理する連携をサポートします。
| ワークフロー | SocQのXエンドポイント | Xの開発者向けプロダクト |
|---|---|---|
| 最適な用途 | プロフィール情報の補完、ポストの調査、モニタリング、公開トピックの発掘 | Xが管理するアプリケーション連携とアカウント連携 |
| 入力の起点 | ユーザー名、ステータスURL、アカウントリスト、検索式、既知のWOEID | プロダクトごとのリクエストと認可済みアカウントのコンテキスト |
| 認証 | SocQのAPIキー | Xの開発者認証情報と該当する認可 |
| データ形式 | 正規化されたプロフィール・ポスト・トレンドのレコード | プロダクトごとのX独自レスポンス |
| 処理モデル | 非同期タスクと結果のページネーション | プロダクトごとのリクエスト・レスポンスのライフサイクル |
X APIの仕組み
X APIはすべて、送信、追跡、取得という共通のパターンを使用します。
1. 入力を送信
ユーザー名、ステータスURL、アカウントリスト、検索クエリ、数値WOEIDを、対応するAPIに送信します。
2. タスクを追跡
task_id を使い、処理が完了するまで /v1/tasks/{task_id} を確認します。
3. 結果を取得
data.results.items を読み取り、has_more が true の間は next_cursor を使用します。
SocQのAPIキーで認証し、1つ以上のXユーザー名を送信します。ポスト、ユーザーのポスト、検索、トレンドも同じタスクフローで利用できます。
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 trueX APIの主なユースケース
クリエイターとパートナーの調査
既知のユーザー名の情報を補完し、公開アカウントの指標を比較して、一貫したクリエイタープロフィールを構築します。
ブランドと市場のモニタリング
選んだアカウントのフォロー、決まった検索の繰り返し、既知のWOEIDのトレンド取得により、ブランド、競合、トピックに関するタイムスタンプ付きのデータセットを構築します。
キャンペーンコンテンツのレポート
キャンペーンのポストURLを解決し、コンテンツ、投稿者、メディア、関係、取得時点のエンゲージメントを整理します。
調査とデータプロダクト
一貫したプロフィールとポストのレコードを、データウェアハウス、分類器、検索インデックス、レビューツール、ダッシュボードで活用します。
制限事項と公開データポリシー
SocQは、タスク実行時点で公開アクセス可能なXのデータを返します。
- プロフィールのカウンターとポストのエンゲージメントは、collected_at 時点のスナップショットです。
- 検索結果は、取得時点で選択した最新順または人気順に従います。
- トレンドの順位と説明は取得元から得たもので、取得時点で指定したWOEIDの状況を表します。
- results_limit は上限を設定するものであり、返される件数はタスク実行中に取得できる対象公開レコードの数によって異なります。
- これらのAPIは公開データの読み取り専用であり、ポストの投稿やXアカウントの管理は行いません。
X APIに関するよくある質問
X APIでは何を取得できますか?
公開プロフィール、フォロワー・フォロー中のリスト、既知のポスト、最近のポスト、返信、引用ポスト、リツイートしたユーザーのプロフィール、検索結果、既知の数値WOEIDの現在のトレンドを取得できます。
どのX APIを選べばよいですか?
アカウントにはProfiles、Followers List、Following List、ステータスURLにはPosts、Post Replies、Post Quotes、Post Retweeters、アカウントの最近のアクティビティにはUser Posts、クエリによる検索にはSearch、既知の数値WOEIDにはTrendsを使用してください。
タスクはどのように処理されますか?
POSTリクエストを送信し、/v1/tasks/{task_id} をポーリングしてから data.results.items を読み取り、has_more が true の間は next_cursor で続きを取得します。
各結果には何が含まれますか?
結果には、そのAPIで取得可能なフィールドが含まれます。たとえば、プロフィールのアカウント情報、ポストの内容とメディア、またはトレンド名、取得元での順位、WOEID、クエリ、説明、取得日時などです。
Xの指標はリアルタイムですか?
いいえ。アカウントのカウンター、ポストのエンゲージメント、トレンドの順位はスナップショットです。結果を比較する際は、collected_at を観測日時として使用してください。
Xデータ取得の料金はどのように計算されますか?
Profilesは結果1件あたり0.6クレジット、個別ポスト、ユーザーのポスト、トレンドは0.5クレジット、検索結果は0.7クレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
LinkedIn API
既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。
Reddit API
既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。
Pinterest API
公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。
Threads API
公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。
Bluesky API
公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。
Snapchat API
既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。