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 하나 이상으로 작업을 시작한 뒤, 리스트마다 팔로우하는 계정을 페이지 단위로 읽습니다.
- {"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 100}을 /v1/x/list-followers로 POST하고 task_id 값을 보관합니다.
- 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-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를 저장해 두면, 나중에 같은 리스트를 다시 내보냈을 때 그사이 새로 팔로우한 계정을 알 수 있습니다.
관련 API
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 — 리스트 멤버를 소개글, 위치, 각종 수치가 담긴 프로필로 내보냅니다.
- 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 Account Location API
- X Verified 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