API一覧に戻る
Xの公開データ

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. 1. 入力を送信

    ユーザー名、ステータスURL、アカウントリスト、検索クエリ、数値WOEIDを、対応するAPIに送信します。

  2. 2. タスクを追跡

    task_id を使い、処理が完了するまで /v1/tasks/{task_id} を確認します。

  3. 3. 結果を取得

    data.results.items を読み取り、has_more が true の間は next_cursor を使用します。

1回のAPIリクエストから始める

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 true

X 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を、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。