x/
community-members

공개 X 커뮤니티 링크로 멤버를 내보내며, 멤버마다 소개, 위치, 웹사이트, 인증 여부, 팔로워 수를 커뮤니티당 최대 2,000명까지 반환합니다.

X Community Members API

커뮤니티 링크 입력
멤버당 프로필 하나
커뮤니티당 최대 2,000명
결과당 0.7 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

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 사용 방법

커뮤니티 링크를 보내고 멤버 프로필을 페이지 단위로 읽습니다.

  1. {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100}을 /v1/x/community-members로 POST합니다.
  2. status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
  3. 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 필드는 비어 있는 경우가 많습니다.

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 — 커뮤니티를 운영하는 관리자와 모더레이터의 프로필을 가져옵니다.

다른 플랫폼 둘러보기

X 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

X Community Members API — 자주 묻는 질문

X Community Members API는 /i/communities/ 링크로 공개 X 커뮤니티의 멤버를 내보내는 프로그래밍 인터페이스입니다. 멤버마다 사용자 이름, 소개, 위치, 웹사이트, 인증 상태, 팔로워·팔로잉·게시물 수가 담긴 프로필 하나를 반환합니다.

네. 입력은 커뮤니티 링크뿐이므로 한 번도 가입하지 않은 공개 커뮤니티의 멤버도 내보낼 수 있고, X 로그인도 필요 없습니다.

X Communities Search에서 키워드로 검색하세요. 결과마다 커뮤니티 url 값이 들어 있으며, 이 엔드포인트에 그대로 넘길 수 있습니다.

최대 2,000명입니다. results_limit 값은 20부터 2,000까지 20의 배수를 받고 기본값은 100이며, 요청에 포함된 커뮤니티 링크마다 따로 적용됩니다.

아니요. published_at 값은 멤버의 X 계정이 만들어진 날짜입니다. 커뮤니티 가입일은 결과에 포함되지 않습니다.

요청한 커뮤니티를 하나도 찾을 수 없으면 작업이 실패하고 크레딧이 전액 환불됩니다. 일부만 찾을 수 없으면 나머지 커뮤니티의 멤버는 그대로 반환됩니다.