X Following List
X 팔로잉 목록은 원본 계정이 어떤 프로필을 팔로우하는지 보여 주는 공개 계정 관계로, 계정 정보, 소개글, 링크, 이미지, 계정 상태, 수치, 생성 정보가 담겨 있습니다. 이러한 레코드는 관심사 네트워크 조사, 계정 탐색, 관계 매핑, 프로필 데이터셋 정보 보강에 활용할 수 있습니다.
X Following List API 주요 기능
- 여러 계정의 팔로잉 수집공개 X 사용자 이름을 하나 이상 받아, 원본 계정마다 상한이 정해진 팔로잉 목록 수집을 각각 적용합니다.
- 프로필 정보와 맥락팔로우 대상 계정의 ID, 사용자 이름, 표시 이름, 정식 URL, 소개글, 웹사이트, 위치, 아바타, 배너, 계정 생성 시각을 반환합니다.
- 계정 신호와 공개 수치공개된 인증, 보호, 메시지, 고정 게시물, 자동화 신호를 팔로워·팔로잉·게시물·미디어·좋아요 수와 함께 제공합니다.
- 원본 정보를 포함한 정규화 레코드저장된 프로필을 일관된 공개 구조로 유지하고, 원본 추적을 위해 collected_at과 extra.input_username을 함께 제공합니다.
X Following List API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 비어 있지 않은 공개 X 사용자 이름의 배열로, 필수 값입니다. 맨 앞의 @는 있어도 없어도 됩니다. |
results_limit | 선택 | 사용자 이름별로 요청할 팔로잉 프로필의 최대 수입니다. 기본값은 200이며 200부터 2000까지 200의 배수를 받습니다. |
X Following List API 사용 방법
공개 원본 사용자 이름을 제출한 뒤, 완료된 비동기 작업에서 정규화된 팔로잉 프로필 레코드를 읽습니다.
- 맨 앞에 @가 있든 없든 상관없이 공개 X 사용자 이름을 하나 이상 준비하고, 사용자 이름별 results_limit은 200부터 2000까지 200의 배수로 정합니다.
- usernames와 results_limit을 /v1/x/following-list로 POST하고, 반환된 task_id를 저장합니다.
- 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링하고, succeeded 또는 failed가 되면 중단합니다.
- 성공하면 data.results.items를 읽고, data.results.has_more가 true인 동안 next_cursor로 작업을 계속 요청합니다.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["@X"],"results_limit":200}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is trueX Following List API 추천 활용 사례
- 관심사 네트워크 조사: 보관해 둔 원본 사용자 이름을 팔로우 대상 프로필의 계정 정보, 소개글, 링크, 위치와 연결해, 알고 있는 계정을 둘러싼 공개 관심사를 살펴봅니다.
- 시드 프로필에서 계정 탐색: 이름, 소개글, 이미지, 인증 신호, 공개 수치를 활용해 원본 프로필의 공개 팔로잉 목록에서 발견한 후보 계정을 검토합니다.
- 관계 목록 정보 보강: 사용자 이름 기반의 기존 관계 레코드에 고정 ID, 정식 프로필 URL, 공개 계정 메타데이터, 수치, 수집 시각을 추가합니다.
X Following List API 활용 팁
- 같은 핸들에 대한 원본 계정 작업이 반복되지 않도록, 제출 전에 맨 앞의 @를 제거하고 대소문자 구분 없이 원본 사용자 이름의 중복을 정리하세요.
- results_limit은 사용자 이름별로 200 단위로 정하세요. 원본이 여러 개이면 목록 끝과 작업 단위 중복 제거를 고려하기 전 기준으로 최대 usernames × results_limit 건의 레코드를 예상해야 합니다.
- 다대다 그래프를 만들 때는 원본 프로필과 대상 프로필 쌍마다 저장 행이 하나씩 있다고 가정하지 마세요. 반복되는 팔로우 대상 프로필은 중복이 제거되어 extra.input_username 값을 하나만 유지할 수 있습니다.
- 비어 있거나 짧은 목록은 공개 범위에 따른 결과로 받아들이고, 선택 이미지·상태 신호·수치는 후속 레코드에서 null로 둘 수 있게 하세요.
- 응답은 관계의 오래됨, 상호작용의 강도, 지지 여부가 아니라 수집 순서를 보여 줄 뿐이므로, 반환 순서를 그런 의미로 해석하지 마세요.
관련 API
X Following List API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
- Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
- X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
- X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
- X Community API — 커뮤니티 링크에서 소개, 멤버 수, 규칙, 가입 정책을 가져옵니다.
- X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
- Twitter Tweet 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 Posts API
- X Thread Context API
- X Verified Followers API
- X List Tweets API
- Twitter List Members 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