x/
community-posts

Xコミュニティのリンクから公開ポストを取得し、ポスト本文、投稿者、エンゲージメント数をまとめて返します。取得上限はコミュニティごとに個別に設定されます。

X Community Posts API

コミュニティのディスカッションを読む
ポスト本文と投稿者
コミュニティごとの上限
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

X Community Posts

Xコミュニティのポストは、トピック別のコミュニティ内で共有されるメッセージで、それぞれに投稿者、投稿日時、本文、添付メディアがあります。これらのポストを反応数とあわせて読むことで、ディスカッションの素材を整理し、コミュニティの公開の会話を構成する個々のポストを比較しやすくなります。

X Community Posts API の主な機能

  • 指定したコミュニティのポストを取得個人のプロフィールに投稿されたポストの集まりではなく、コミュニティのリンクを起点にそのコミュニティ内の公開ディスカッションを取得します。
  • コミュニティごとに個別の上限を適用複数のコミュニティリンクを指定すると results_limit はそれぞれに適用され、ポストは作成日時順に取得されます。入力でディスカッションスペースごとの取得件数を指定できます。
  • メッセージと関連情報をまとめて保持各ポストレコードには本文、投稿者情報、投稿日時、メディア、取得可能な反応数が含まれるため、誰がいつ投稿したかを見失わずにメッセージを確認できます。

X Community Posts API のパラメータ

パラメータ必須説明
urls必須必須。https://x.com/i/communities/1493446837214187523 のように数値のコミュニティIDを含む、公開Xコミュニティのリンクのリストです。Playgroundでは1行に1つずつリンクを入力し、コードではJSONの urls 配列を使用してください。プロフィール、検索、個別ポストのリンクは使用できません。
results_limit任意任意。コミュニティごとのポストの最大数です。デフォルトは100で、20、40、100など20から2000までの20の倍数を指定できます。コミュニティリンクが2つで上限が20の場合、各コミュニティから最大20件のポストを取得できます。

X Community Posts API の使い方

リクエストはバックグラウンドの取得タスクを開始するため、最初のレスポンスでは完成したデータではなくタスクIDが返されます。そのIDを使って進行状況を確認し、結果を取得します。

  1. 読みたいコミュニティのリンクをコピーし、20や100などコミュニティごとの上限を決めます。個別ポストのURLではなく、コミュニティのリンクを使用してください。
  2. 例を実行する前に、$SOCQ_API_KEY をご自身のAPIキーに置き換えるか、その環境変数を設定してください。下記の Authorization ヘッダーを付けてJSON入力を POST /v1/x/community-posts に送信し、レスポンスの task_id を保存します。
  3. 保存したIDで GET /v1/tasks/{task_id} を呼び出して進行状況を確認します。queued は待機中、running は取得中、retrying は再試行中を意味します。結果を読み取る前に succeeded になるまで待ってください。タスクが failed になった場合は、error_message で理由を確認してください。
  4. タスクが成功したら data.results.items を読み取ります。このリストの各項目が1件のコミュニティポストを表します。リストが空の場合は、タスクがレコードを返さずに完了したことを意味します。
  5. data.results.has_more が true の場合、next_cursor の値は保存済み結果の次のページを示すマーカーです。その値をそのまま GET /v1/tasks/{task_id}?cursor=... の cursor パラメータにコピーし、has_more が false になるまで続けてください。
curl -X POST "https://api.socq.ai/v1/x/community-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":20}'

X Community Posts API の主なユースケース

  • ディスカッションダイジェストの素材準備: 取得したポスト本文、投稿者のハンドル、リンク、日時を読書リストにまとめ、担当者や別の要約ツールがそれらのポストのダイジェストを作成できるようにします。
  • 保存したスナップショット間でのポストの反応数比較: ポストIDと返されたカウントを取得時刻とともに保存し、後の取得で同じポストと照合して、取得可能なカウントの変化を自分で算出します。
  • 選んだポストの周辺の会話を調査: コミュニティの結果からポストを選び、そのポストURLを X Thread Context に渡して、そのメッセージの前後にある取得可能なポストや返信を読みます。

X Community Posts API 活用のヒント

  • まとめて取得する計画を立てる際は、コミュニティリンクの数に results_limit を掛けてリクエストするレコード数を見積もり、上限がすべてのコミュニティで共有されるとは考えずに、ポスト単位の料金で計算してください。
  • 取得を繰り返す場合、同じポストが後のタスクで再び現れることがあるため、保存済みのテーブルに追加する前にポストIDで照合してください。
  • 複数のコミュニティの結果を保持する場合は、送信したコミュニティリンクをタスクの入力とともに保存してください。標準のポストレコードには、その入力情報の代わりになるコミュニティIDが必ず含まれるとは限りません。

X Community Posts API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • Twitter Mentions API — 指定したアカウントをメンションしている公開ポストを取得します。
  • X Thread Context API — ポストと、その返信チェーンをさかのぼった過去のメッセージ、公開返信、関連IDを取得します。
  • X List Tweets API — リストのタイムラインを新しい順に取得し、リポストには元の投稿者を示します。

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

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

X Community Posts API — よくある質問

X Community Posts APIは、Xコミュニティのリンクのリストから公開ポストを取得するためのプログラムインターフェースです。ポスト本文、投稿者、メディア、タイムスタンプ、反応数を作成日時順に返し、コミュニティごとに取得上限が適用されます。

コミュニティはそのディスカッションスペース内で共有されたポストをまとめたもので、プロフィールのタイムラインは1つのアカウントのポストをまとめたものです。ここではコミュニティのリンクを指定し、アカウントのユーザー名を起点にする場合は X User Posts を使用してください。

いいえ。コミュニティリンクごとに最大100件という意味です。たとえば3つのコミュニティでは合計最大300件をリクエストできますが、公開状況や重複排除によって最終的なレコード数が減ることがあります。

上限は20単位で指定する必要があるため、20、40、60、100などの値を使用してください。指定できる範囲は20から2000までで、デフォルトは100です。

いいえ。タスクのカーソルは、そのタスクがすでに保存した結果の別のページを読むためのものです。元のコミュニティごとの上限を増やしたり、新しい取得を開始したりするものではありません。

いいえ。このAPIが返すのは、読んだり整理したり、別の要約プロセスに渡したりできるポストレコードです。完成した要約や分析はレスポンスに含まれません。

返されたポスト1件につき0.7クレジットで、基本料金はありません。コミュニティリンクが2つで上限が100の場合、見積もりは140クレジットです。タスクが合計30件のポストを返した場合、最終的な料金は21クレジットです。