x/
following-list

하나 이상의 사용자 이름이 팔로우하는 공개 X 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 수치, 원본 계정 정보를 반환합니다.

X Following List API

팔로잉 관계
프로필 정보
계정별 수량 제한
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

공개 원본 사용자 이름을 제출한 뒤, 완료된 비동기 작업에서 정규화된 팔로잉 프로필 레코드를 읽습니다.

  1. 맨 앞에 @가 있든 없든 상관없이 공개 X 사용자 이름을 하나 이상 준비하고, 사용자 이름별 results_limit은 200부터 2000까지 200의 배수로 정합니다.
  2. usernames와 results_limit을 /v1/x/following-list로 POST하고, 반환된 task_id를 저장합니다.
  3. 작업이 queued, running, retrying 상태인 동안 GET /v1/tasks/{task_id}를 폴링하고, succeeded 또는 failed가 되면 중단합니다.
  4. 성공하면 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 true

X Following List API 추천 활용 사례

  • 관심사 네트워크 조사: 보관해 둔 원본 사용자 이름을 팔로우 대상 프로필의 계정 정보, 소개글, 링크, 위치와 연결해, 알고 있는 계정을 둘러싼 공개 관심사를 살펴봅니다.
  • 시드 프로필에서 계정 탐색: 이름, 소개글, 이미지, 인증 신호, 공개 수치를 활용해 원본 프로필의 공개 팔로잉 목록에서 발견한 후보 계정을 검토합니다.
  • 관계 목록 정보 보강: 사용자 이름 기반의 기존 관계 레코드에 고정 ID, 정식 프로필 URL, 공개 계정 메타데이터, 수치, 수집 시각을 추가합니다.

X Following List API 활용 팁

  • 같은 핸들에 대한 원본 계정 작업이 반복되지 않도록, 제출 전에 맨 앞의 @를 제거하고 대소문자 구분 없이 원본 사용자 이름의 중복을 정리하세요.
  • results_limit은 사용자 이름별로 200 단위로 정하세요. 원본이 여러 개이면 목록 끝과 작업 단위 중복 제거를 고려하기 전 기준으로 최대 usernames × results_limit 건의 레코드를 예상해야 합니다.
  • 다대다 그래프를 만들 때는 원본 프로필과 대상 프로필 쌍마다 저장 행이 하나씩 있다고 가정하지 마세요. 반복되는 팔로우 대상 프로필은 중복이 제거되어 extra.input_username 값을 하나만 유지할 수 있습니다.
  • 비어 있거나 짧은 목록은 공개 범위에 따른 결과로 받아들이고, 선택 이미지·상태 신호·수치는 후속 레코드에서 null로 둘 수 있게 하세요.
  • 응답은 관계의 오래됨, 상호작용의 강도, 지지 여부가 아니라 수집 순서를 보여 줄 뿐이므로, 반환 순서를 그런 의미로 해석하지 마세요.

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 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.

다른 플랫폼 둘러보기

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

X Following List API — 자주 묻는 질문

X Following List API는 하나 이상의 X 사용자 이름이 팔로우하는 공개 프로필을 수집하는 프로그래밍 인터페이스입니다. 정규화된 계정 정보, 소개글, 링크, 이미지, 계정 신호, 공개된 수치, 타임스탬프, 원본 정보를 반환합니다.

비어 있지 않은 usernames 배열을 제출합니다. 공개 핸들의 맨 앞 @는 있어도 없어도 되며, 같은 원본 사용자 이름은 제공처 수집 전에 대소문자 구분 없이 정규화됩니다.

results_limit의 기본값은 200이고 2000까지 200의 배수를 받으며, 원본 사용자 이름마다 따로 적용됩니다. 공개된 목록이 요청한 상한보다 먼저 끝날 수 있습니다.

레코드에는 프로필 ID, 사용자 이름, 표시 이름, 정식 URL, 소개글, 웹사이트, 위치, 아바타, 배너, 인증·보호 신호, 공개 수치, 계정 생성 시각, 수집 시각, extra.input_username이 포함될 수 있습니다.

꼭 그렇지는 않습니다. 고정된 프로필 식별 정보는 결과를 저장할 때 중복이 제거되므로, 제출한 여러 계정이 팔로우하는 프로필은 저장된 레코드에 원본 정보가 유지된 채 한 번만 나타날 수 있습니다.

보호되었거나 제한된 계정, 공개 범위 제한, 사용할 수 없는 목록 페이지, 공개된 팔로잉 목록의 끝에 도달한 경우 저장되는 레코드가 줄어들 수 있습니다. 재시도하기 전에 원본 계정이 공개 상태로 접근 가능한지 확인하세요.

아니요. 순서는 수집 순서로만 보세요. 관계가 언제 시작되었는지, 계정끼리 얼마나 자주 상호작용하는지, 원본 계정이 팔로우 대상 프로필을 지지하는지는 알 수 없습니다.

저장된 정규화 프로필 레코드 하나당 0.5 크레딧이 차감됩니다. 실제로 저장된 레코드 수를 기준으로 청구하므로, 결과가 없으면 결과 단위 요금이 없습니다.