X Community Moderators
X 커뮤니티 모더레이터는 커뮤니티가 주제에서 벗어나지 않게 관리하는 관리자와 모더레이터로, 규칙을 정하고 어떤 게시물과 멤버를 남길지 결정하는 사람들이며, 각자 소개, 웹사이트, 위치, 인증 상태, 팔로워 수가 담긴 공개 프로필을 갖고 있습니다. 운영진이 누구이고 각자 개인적으로 얼마나 큰 도달 범위를 가졌는지 알면, 커뮤니티와 관련해 누구에게 연락해야 할지와 실제로 누가 그 커뮤니티를 이끄는지 파악할 수 있습니다.
X Community Moderators API 주요 기능
- 운영진 전체를 한 번에커뮤니티 링크마다 모든 관리자와 모더레이터가 한 작업에서 함께 반환되며, 결과 규모는 운영진 인원에 따라 정해집니다.
- 바로 연락 가능한 프로필운영진마다 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 값은 프로필에 표시되는 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 — 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