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を使って進行状況を確認し、結果を取得します。
- 読みたいコミュニティのリンクをコピーし、20や100などコミュニティごとの上限を決めます。個別ポストのURLではなく、コミュニティのリンクを使用してください。
- 例を実行する前に、$SOCQ_API_KEY をご自身のAPIキーに置き換えるか、その環境変数を設定してください。下記の Authorization ヘッダーを付けてJSON入力を POST /v1/x/community-posts に送信し、レスポンスの task_id を保存します。
- 保存したIDで GET /v1/tasks/{task_id} を呼び出して進行状況を確認します。queued は待機中、running は取得中、retrying は再試行中を意味します。結果を読み取る前に succeeded になるまで待ってください。タスクが failed になった場合は、error_message で理由を確認してください。
- タスクが成功したら data.results.items を読み取ります。このリストの各項目が1件のコミュニティポストを表します。リストが空の場合は、タスクがレコードを返さずに完了したことを意味します。
- 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が必ず含まれるとは限りません。
関連API
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 — リストのタイムラインを新しい順に取得し、リポストには元の投稿者を示します。
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API