X Community Members
X 커뮤니티 멤버는 주제 기반 커뮤니티에 스스로 가입한 계정이며, 각 계정에는 소개, 위치, 웹사이트, 인증 상태, 계정 생성일, 팔로워·팔로잉·게시물 수가 담긴 공개 프로필이 있습니다. 한 가지 주제를 두고 의도적으로 가입한 사람들이므로 이 프로필들은 스스로 모인 오디언스를 보여 주며, 규모를 가늠하고, 도달 범위나 지역별로 세분화하고, 이웃 커뮤니티의 멤버 구성과 견줘 볼 수 있습니다.
X Community Members API 주요 기능
- 커뮤니티 링크로 멤버 목록 가져오기https://x.com/i/communities/<id> 링크를 하나 이상 붙여 넣으면 커뮤니티마다 모든 멤버가 각각의 프로필 행으로 반환됩니다.
- 멤버 한 명 한 명의 정체행에는 username, 표시 이름, text 필드의 소개, 프로필 사진, 커버 이미지, 웹사이트, 직접 밝힌 위치가 담겨 있어 내보낸 결과만으로 멤버를 알아보고 설명할 수 있습니다.
- 멤버마다 도달 범위metrics에 followers_count, following_count, posts_count 값이 있어 커뮤니티의 큰 목소리와 조용한 다수를 구분해 줍니다.
- 인증 여부와 계정 연령is_verified, is_private 값과 멤버의 X 계정 생성일인 published_at 값으로 목록 속 각 사람이 얼마나 자리 잡은 계정인지 한눈에 볼 수 있습니다.
X Community Members API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | https://x.com/i/communities/<numeric_id> 형식의 공개 X 커뮤니티 링크이며, 한 줄에 하나씩 입력합니다. |
results_limit | 선택 | 커뮤니티마다 반환할 멤버 수로, 20부터 2,000까지 20의 배수를 받습니다. 기본값은 100입니다. |
X Community Members API 사용 방법
커뮤니티 링크를 보내고 멤버 프로필을 페이지 단위로 읽습니다.
- {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100}을 /v1/x/community-members로 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-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/i/communities/1493446837214187523"],"results_limit":100}'
# results_limit is applied to each community in urls, so two links can return up to 200 members here.X Community Members API 추천 활용 사례
- 커뮤니티 오디언스 프로파일링: 멤버를 location.name 값으로 묶고, text 필드의 소개에서 직함과 관심사를 훑고, followers_count 분포를 차트로 그려 실제로 누가 가입했는지 정리합니다.
- 제휴할 멤버 후보 추리기: 멤버를 metrics.followers_count 기준으로 정렬하고 인증된 멤버를 남긴 뒤, website와 소개를 보고 해당 분야에서 연락할 만한 크리에이터를 고릅니다.
- 두 커뮤니티의 겹침 측정: 관련된 두 커뮤니티의 멤버를 내보내고 id로 매칭해 양쪽에 모두 속한 사람 수를 셉니다.
- 커뮤니티의 신규 계정 비율 점검: 최근 published_at 값과 낮은 posts_count, followers_count 값을 함께 보고, 커뮤니티 멤버 중 새로 만들어졌거나 거의 활동하지 않는 계정의 비율을 확인합니다.
X Community Members API 활용 팁
- 멤버 구성을 비교할 계획이라면 작업 하나에 커뮤니티 하나씩 보내세요. 멤버 행에는 프로필만 담기므로 각 행을 커뮤니티와 이어 주는 것은 작업 입력입니다.
- 먼저 X Community나 X Communities Search에서 members_count 값을 확인하고, 그보다 큰 가장 가까운 20의 배수로 results_limit 값을 정하면 한 작업으로 전체 목록을 요청할 수 있습니다.
- 국가별로 묶기 전에 location.name 값을 정규화하세요. 멤버가 직접 입력한 "Sydney" 같은 자유 형식 장소가 들어 있고, city와 country 필드는 비어 있는 경우가 많습니다.
관련 API
X Community Members API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
- X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
- X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
- X Community API — 커뮤니티 링크에서 소개, 멤버 수, 규칙, 가입 정책을 가져옵니다.
- X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
- X Community Moderators API — 커뮤니티를 운영하는 관리자와 모더레이터의 프로필을 가져옵니다.
- Twitter Tweet Scraper API
- Twitter User Tweets 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 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