x/
list-followers

공개 X 리스트를 누가 팔로우하는지 확인합니다. 리스트 URL을 제출하면 팔로워마다 소개, 위치, 인증 여부, 가입일, 팔로워·팔로잉·게시물 수를 받을 수 있습니다.

Twitter List Followers API

리스트 URL 입력
리스트 구독자
리스트당 최대 2,000개
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter List Followers

트위터 리스트 팔로워는 X 리스트 멤버의 트윗을 읽으려고 그 리스트를 구독한 계정이며, 각 계정에는 소개, 위치, 인증 여부, 가입일, 팔로워·팔로잉·게시물 수가 담긴 공개 프로필이 있습니다. 리스트를 팔로우한다는 것은 그 주제를 계속 지켜보겠다는 선택이므로, 이 프로필들은 해당 분야가 어떤 사람을 끌어들이는지 보여 주고, 관련 리스트의 독자를 비교하게 해 주며, 그 주제로 연락해 볼 만한 사람을 짚어 줍니다.

Twitter List Followers API 주요 기능

  • 공개 리스트의 구독자x.com/i/lists/<id> 링크를 제출하면 리스트마다 타임라인을 팔로우하기로 한 계정을 리스트당 최대 2,000개까지 받습니다.
  • 팔로워 한 명 한 명의 정체행마다 username, 표시 이름, text 필드의 소개, 프로필 사진, 커버 이미지, 웹사이트, location.name 값이 들어 있어, 리스트가 어떤 사람들을 끌어들이는지 함께 보여 줍니다.
  • 도달 범위, 활동량, 가입 기간, 인증 여부metrics.followers_count, following_count, posts_count 값, 가입일인 published_at 값, is_verified 값을 함께 보면 자리 잡은 활발한 팔로워와 새 계정이나 활동이 적은 계정을 구분할 수 있습니다.

Twitter List Followers API 매개변수

매개변수필수설명
urls필수https://x.com/i/lists/<numeric id> 형식의 공개 X 리스트 URL을 하나 이상 넣습니다. 포함한 리스트마다 팔로워가 수집됩니다.
results_limit선택리스트마다 수집할 팔로워 수로, 20부터 2,000 사이의 20의 배수이며 기본값은 100입니다.

Twitter List Followers API 사용 방법

리스트 URL 하나 이상으로 작업을 시작한 뒤, 리스트마다 팔로우하는 계정을 페이지 단위로 읽습니다.

  1. {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}을 /v1/x/list-followers로 POST하고 task_id 값을 보관합니다.
  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-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/lists/1940592907737845989"],"results_limit":100}'

# Every item is an account that follows the list; the list's members come from /v1/x/list-members.

Twitter List Followers API 추천 활용 사례

  • 내 리스트의 팔로워 확인: 직접 관리하는 공개 리스트의 팔로워를 수집해 누가 읽는지, 그중 followers_count 기준으로 오디언스가 가장 큰 독자는 누구인지 파악합니다.
  • 주제별 오디언스 프로파일링: 기후 테크나 SaaS 창업자 리스트를 팔로우하는 사람들의 소개와 location.name 값을 읽어, 그 주제에 관심 있는 사람이 누구인지 정리합니다.
  • 연락할 사람 후보 추리기: text 필드의 키워드와 followers_count 값으로 팔로워를 필터링해, 이미 내 분야의 글을 읽고 있는 계정을 고릅니다.
  • 경쟁 리스트의 독자 비교: 같은 주제의 리스트 두 개의 팔로워를 한 작업에서 수집하고 id로 매칭해, 공통 독자와 각 리스트에만 있는 독자를 찾습니다.
  • 유사 타기팅용 시드 오디언스 만들기: 잘 꾸려진 리스트 팔로워의 username과 id 값을 내보내, 광고 도구의 유사 타기팅이나 관심사 타기팅용 시드로 활용합니다.

Twitter List Followers API 활용 팁

  • Twitter List Members API로 가져온 리스트 멤버와 팔로워를 id로 매칭하면, 리스트를 팔로우하는 멤버와 리스트 밖에 있는 독자를 구분할 수 있습니다.
  • 비교하는 모든 리스트에 같은 results_limit 값을 적용해 오디언스마다 같은 깊이로 수집하세요.
  • 수집할 때마다 팔로워 id를 저장해 두면, 나중에 같은 리스트를 다시 내보냈을 때 그사이 새로 팔로우한 계정을 알 수 있습니다.

Twitter List Followers 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 List Tweets API — 리스트 타임라인을 최신순으로 가져오며, 리포스트에는 원 작성자를 표시합니다.
  • Twitter List Members API — 리스트 멤버를 소개글, 위치, 각종 수치가 담긴 프로필로 내보냅니다.

다른 플랫폼 둘러보기

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

Twitter List Followers API — 자주 묻는 질문

Twitter List Followers API는 리스트마다 /i/lists/ URL을 사용해 공개 X 리스트를 팔로우, 즉 구독하는 계정을 수집하는 프로그래밍 인터페이스입니다. 팔로워마다 사용자 이름, 이름, 소개, 위치, 웹사이트, 인증·비공개 여부, 가입일, 팔로워·팔로잉·게시물 수를 반환합니다.

네, 공개 리스트라면 가능합니다. 리스트 URL을 제출하면 구독자마다 프로필 행으로 리스트당 최대 2,000개까지 반환됩니다.

팔로워는 리스트 타임라인을 읽으려고 구독한 계정이고, 멤버는 리스트 소유자가 추가한 계정입니다. 이 API는 팔로워를, Twitter List Members API는 멤버를 반환합니다.

아니요. 리스트의 구독자를 반환합니다. 사용자 프로필을 팔로우하는 계정이 필요하면 X Followers List API를 사용하세요.

작은 리스트는 구독자가 몇 명뿐인 경우가 많으며, 결과에는 리스트를 팔로우하는 계정이 정확히 그만큼 담깁니다. 반환된 팔로워 1명당 0.7 크레딧이 차감되고, 결과가 비어 있으면 요금이 청구되지 않습니다.