x/
list-members

리스트 URL로 공개 X 리스트에 속한 계정을 내보내며, 멤버마다 사용자 이름, 소개, 위치, 웹사이트, 인증 여부, 팔로워·팔로잉·게시물 수를 반환합니다.

Twitter List Members API

리스트 URL 입력
소유자가 추가한 계정
멤버별 전체 프로필
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter List Members

트위터 리스트 멤버는 X 리스트 소유자가 직접 골라 추가한 계정이며, 각 계정에는 이름, 소개, 위치, 웹사이트, 인증 여부, 가입일, 팔로워·팔로잉·게시물 수가 담긴 공개 프로필이 있습니다. 해당 분야를 아는 사람이 이미 선별해 둔 목록이므로 이 프로필들은 잠재 고객 발굴, 인플루언서 조사, 계정 정보 보강에 바로 쓸 수 있는 후보 목록이 되고, 주기적으로 스냅샷을 남기면 엄선된 그룹의 변화도 기록할 수 있습니다.

Twitter List Members API 주요 기능

  • 리스트 URL로 소유자가 고른 계정 가져오기제출한 x.com/i/lists/<id> URL마다 소유자가 리스트에 넣은 계정이 리스트당 최대 2,000개까지 반환되어, 손으로 고른 그룹을 정렬·필터링 가능한 행으로 바꿔 줍니다.
  • 멤버마다 전체 프로필행에는 username, 표시 이름, text 필드의 소개, 프로필 사진과 커버 이미지, 웹사이트, location.name 값이 담겨 있어 행만 보고도 계정이 맞는지 판단할 수 있습니다.
  • 도달 범위, 활동량, 계정 연령metrics.followers_count, following_count, posts_count 값은 멤버마다 오디언스와 게시량을 보여 주고, published_at 값은 계정이 X에 가입한 날짜를 알려 줍니다.
  • 인증·비공개 표시is_verified와 is_private 값이 인증된 멤버와 보호된 계정을 표시하므로 그룹별로 따로 다룰 수 있습니다.

Twitter List Members API 매개변수

매개변수필수설명
urls필수/i/lists/<numeric id>로 끝나는 공개 X 리스트 URL입니다(예: https://x.com/i/lists/1940592907737845989). 리스트마다 멤버가 따로 반환됩니다.
results_limit선택리스트마다 내보낼 최대 멤버 수로, 20부터 2,000까지 20 단위로 지정합니다. 기본값은 100입니다.

Twitter List Members API 사용 방법

내보낼 리스트 URL을 제출하고 작업이 끝나면 멤버 프로필을 수집합니다.

  1. x.com에서 각 리스트의 URL을 복사하고 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}을 /v1/x/list-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/list-members" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Each member's bio is in text and the date the account joined X is in published_at.

Twitter List Members API 추천 활용 사례

  • 엄선된 리스트를 잠재 고객 후보로: 핀테크 창업자나 AI 연구자 리스트 등을 내보낸 뒤, 연락하기 전에 text 필드의 소개와 website 값이 제안 내용과 맞는 멤버만 남깁니다.
  • 분야별 계정 순위와 등급 나누기: 멤버를 metrics.followers_count 기준으로 정렬하고 is_verified나 location.name 값으로 나눠, 가장 영향력 있는 계정과 지역별 그룹을 구분합니다.
  • CRM과 리드 기록 보강: 멤버의 계정 id로 매칭해 연락처 기록에 username, website, location.name, 소개를 추가합니다.
  • 리스트 변화 기록: 같은 리스트를 정기적으로 내보내고 수집 간 멤버 id를 비교해 누가 추가되거나 빠졌는지 확인합니다.

Twitter List Members API 활용 팁

  • 사용자 이름은 바뀔 수 있으므로 내보내기 결과 간 멤버는 id로 매칭하세요.
  • 멤버가 밝힌 위치는 location.name 값으로 읽으세요. 장소가 표시되어 있어도 city, region, country 값은 null일 수 있으므로, 국가별로 묶기 전에 location.name 값을 직접 파싱하세요.
  • 리스트 멤버 수보다 큰 가장 가까운 20의 배수로 results_limit 값을 정하면 한 작업으로 리스트 전체를 내보낼 수 있습니다. 요금은 반환된 멤버에만 청구됩니다.
  • 같은 리스트 URL을 X List Tweets API에 보내면 멤버들이 무엇을 게시하는지, Twitter List Followers API에 보내면 누가 그 리스트를 읽는지 알 수 있습니다.

Twitter List Members API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
  • X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
  • X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
  • X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
  • X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
  • X List Tweets API — 리스트 타임라인을 최신순으로 가져오며, 리포스트에는 원 작성자를 표시합니다.

다른 플랫폼 둘러보기

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

Twitter List Members API — 자주 묻는 질문

Twitter List Members API는 리스트마다 /i/lists/ URL을 사용해 공개 X 리스트에 속한 계정을 내보내는 프로그래밍 인터페이스입니다. 멤버마다 사용자 이름, 이름, 소개, 위치, 웹사이트, 인증·비공개 여부, 가입일, 팔로워·팔로잉·게시물 수가 담긴 프로필을 반환합니다.

x.com에서 리스트 URL을 복사해 results_limit 값과 함께 urls 배열로 제출하고, 완료된 작업에서 멤버 프로필을 읽으면 됩니다. has_more가 true인 동안 next_cursor로 이어서 가져오세요. 멤버마다 스프레드시트나 CRM에 기록할 수 있는 JSON 레코드로 제공됩니다.

네. 공개 리스트라면 누가 만들었든 URL로 내보낼 수 있습니다.

리스트당 최대 2,000명이며 results_limit 값으로 20 단위로 지정합니다. 기본값은 100입니다. 리스트를 여러 개 제출하면 상한이 각각에 적용됩니다.

반환된 멤버 1명당 0.7 크레딧이 차감되므로, 멤버 100명인 리스트는 70 크레딧입니다. 결과가 비어 있으면 요금이 청구되지 않습니다.