X Community Moderators
Xコミュニティのモデレーターとは、コミュニティの話題がそれないように保つ管理者とモデレーターのことで、ルールを書き、どのポストやメンバーを残すかを決める人たちであり、それぞれにプロフィール文、ウェブサイト、所在地、認証状態、フォロワー数を示す公開プロフィールがあります。そのチームに誰がいて、各人が個人としてどれだけのリーチを持っているかがわかれば、コミュニティについて誰に相談すべきか、実際に誰が背後にいるのかが見えてきます。
X Community Moderators API の主な機能
- モデレーションチーム全員を一度に各コミュニティのリンクから、すべての管理者とモデレーターが1つのタスクでまとめて返り、結果の件数はチームの規模そのものに合わせて決まります。
- 連絡に使えるプロフィールチームの各メンバーには username、表示名、text に入ったプロフィール文、ウェブサイト、所在地、アイコン画像、ヘッダー画像が付き、たいていは連絡方法を判断するのに十分です。
- 各モデレーターの影響力フォロワー数・フォロー数・ポスト数が is_verified、アカウント作成日である published_at と並ぶため、コミュニティが定着したアカウントによって運営されているかを確認できます。
X Community Moderators API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 管理者とモデレーターを取得したい公開Xコミュニティのリンクで、いずれも https://x.com/i/communities/<numeric_id> の形式です。 |
X Community Moderators API の使い方
コミュニティのリンクを送信し、そのモデレーションチームを読み取ります。
- {"urls": ["https://x.com/i/communities/1493446837214187523"]} を /v1/x/community-moderators に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- results.items から管理者とモデレーターのプロフィールを読み取り、has_more が true の間は results.next_cursor をたどります。
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"]}'
# Admins and moderators arrive together as profile rows, the whole team for each community.X Community Moderators API の主なユースケース
- コミュニティへのスポンサーシップやAMAの提案: モデレーターの名前、プロフィール文、ウェブサイトのリンクを使い、コミュニティのフィードに何を載せるかを決める人たちに連絡します。
- 力を入れる前のコミュニティの見極め: 投稿、スポンサー、参加の前に、運営チームが認証済みか、published_at から見たアカウントの古さ、各自のフォロワー規模を確認します。
- 複数のコミュニティを運営する人の発見: ニッチな分野のコミュニティのモデレーションチームを集め、id でプロフィールを照合して、複数のコミュニティでモデレーターを務めるアカウントを見つけます。
X Community Moderators API 活用のヒント
- 誰がどのコミュニティをモデレートしているかを知る必要がある場合は、コミュニティごとに個別のタスクにしてください。プロフィールの行は人物を表し、コミュニティを特定するのは送信したリンクです。
- website の値には、Xがプロフィールに表示する t.co の短縮リンクが入っているため、保存や利用の前に展開してください。
- モデレーターがブランドやプロジェクトのアカウントの場合は、text のプロフィール文にある @ハンドルを確認してください。「Tweets by @marckohlbrugge」のように、背後にいる人物がそこに書かれていることがよくあります。
関連API
X Community Moderators API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。
- Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
- Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
- X Followers List API — 1つ以上のXユーザー名について、公開フォロワーのアカウント情報と表示中のプロフィール指標を取得します。
- X Following List API — 公開Xアカウントがフォローしているプロフィールを、アカウント情報、プロフィール文、アカウントシグナル、表示中のカウント、元のユーザー名とともに取得します。
- X Community API — コミュニティのリンクから、説明、メンバー数、ルール、参加ポリシーを取得します。
- X Community Members API — コミュニティのメンバーを、自己紹介とフォロワー数を含むプロフィールとして書き出します。
- Twitter Tweet Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers 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