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을 제출하고 작업이 끝나면 멤버 프로필을 수집합니다.
- x.com에서 각 리스트의 URL을 복사하고 {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}을 /v1/x/list-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/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에 보내면 누가 그 리스트를 읽는지 알 수 있습니다.
관련 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 — 리스트 타임라인을 최신순으로 가져오며, 리포스트에는 원 작성자를 표시합니다.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Verified Followers API
- Twitter List Followers API
- X Community Members API
- X Community Moderators 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