x/
verified-followers

사용자 이름으로 X 프로필을 팔로우하는 인증 계정을 수집하며, 팔로워마다 핸들, 이름, 프로필 링크, 프로필 사진, 가입일을 계정당 최대 2,000개까지 반환합니다.

X Verified Followers API

인증된 팔로워 탭
계정당 최대 2,000개
팔로워 가입일
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

X Verified Followers

X 인증된 팔로워는 계정의 팔로워 중 인증 체크 표시가 있는 계정으로, 프로필의 인증된 팔로워 탭에 따로 모여 있으며 팔로워마다 핸들, 표시 이름, 프로필 사진, X 가입일이 함께 보입니다. 크리에이터, 브랜드, 유료 사용자로 채워지는 목록이라 이미 자리 잡은 계정 중 누가 그 프로필에 관심을 두는지 보여 주고, 아웃리치, 경쟁사 조사, 오디언스 품질 점검에 쓸 수 있는 압축된 표본이 됩니다.

X Verified Followers API 주요 기능

  • 인증된 팔로워 탭의 팔로워X가 프로필의 인증된 팔로워 탭에 보여 주는 목록과 같은 목록에서 행을 가져오므로, 반환되는 모든 팔로워의 is_verified 값이 true입니다.
  • 행마다 두 계정을 함께 표기actor는 조회를 요청한 계정, related_actor는 인증된 팔로워이며 relationship 값은 follower로 표시되어, 여러 사용자 이름의 행을 하나의 결과에서도 구분할 수 있습니다.
  • 팔로워 신원과 프로필 링크related_actor 필드에는 팔로워마다 id, username, 표시 이름, 프로필 url, avatar_url 값이 들어 있어 계정을 열어 보거나 검토하거나 내보내기에 충분합니다.
  • 팔로워의 X 가입 시점각 행의 published_at 값은 인증된 팔로워 계정의 가입일로, 오래된 계정과 최근에 만들어진 계정을 구분해 줍니다.
  • 사용자 이름당 20~2,000개 깊이results_limit 값은 사용자 이름마다 20 단위로 적용되며, 20개 계정의 간단한 표본부터 인증된 팔로워 2,000개까지 정할 수 있습니다.

X Verified Followers API 매개변수

매개변수필수설명
usernames필수인증된 팔로워를 수집할 X 사용자 이름입니다. 계정마다 따로 수집됩니다.
results_limit선택사용자 이름마다 반환할 인증된 팔로워 수로, 20부터 2,000까지 20의 배수를 받습니다. 기본값은 100입니다.

X Verified Followers API 사용 방법

사용자 이름을 제출하고 각각 수집할 인증된 팔로워 수를 정한 뒤 행을 페이지 단위로 읽습니다.

  1. {"usernames": ["NASA"], "results_limit": 100}을 /v1/x/verified-followers로 POST합니다.
  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/verified-followers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["NASA"],"results_limit":100}'

# related_actor is the verified follower; actor is the account you asked about.

X Verified Followers API 추천 활용 사례

  • 경쟁사의 인증 오디언스로 아웃리치 목록 만들기: 경쟁사의 인증된 팔로워를 수집하고 related_actor.username과 url 값을 내보내, 이미 해당 카테고리를 팔로우하는 크리에이터, 브랜드, 구독자에게 연락합니다.
  • 경쟁사만 팔로우하는 인증 계정 찾기: 내 계정과 경쟁사 계정의 인증된 팔로워를 한 작업에서 수집한 뒤, 경쟁사 목록에만 나오는 related_actor.id 값을 남깁니다.
  • 여러 프로필의 인증 오디언스 비교: 사용자 이름 여러 개를 함께 제출하고 행 수와 겹치는 related_actor.id 값을 비교해, 어떤 프로필들이 같은 인증 계정을 끌어들이는지 확인합니다.
  • 새로 만들어진 인증 팔로워의 급증 포착: 프로필의 인증된 팔로워를 published_at 기준으로 정렬해, 체크 표시 오디언스가 오래된 계정 위주인지 최근 X에 가입한 계정 위주인지 확인합니다.

X Verified Followers API 활용 팁

  • 먼저 results_limit 값을 20으로 두고 수집할 만한 인증 오디언스가 있는지 확인한 뒤 늘리세요. 반환된 팔로워 1명당 0.7 크레딧이 차감됩니다.
  • 한 사용자 이름에서 정확히 results_limit 값만큼 행이 나오면 인증된 팔로워 목록이 더 이어질 수 있으니, 전체 그림을 보려면 상한을 2,000에 가깝게 올리세요.
  • 팔로워는 related_actor.id 값을 키로 저장하고 collected_at 기준으로 수집 결과를 비교하면, 지난 확인 이후 새로 생긴 인증 계정을 알 수 있습니다.
  • 조회를 요청한 계정은 actor.username 값으로 확인하세요. 나머지 actor 필드는 비어 있을 수 있고, 팔로워의 상세 정보는 related_actor 필드에 들어 있습니다.

X Verified 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 Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
  • Twitter Follow Checker API — 한 계정이 다른 계정들을 팔로우하는지, 상대가 맞팔로우하는지 확인합니다.

다른 플랫폼 둘러보기

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

X Verified Followers API — 자주 묻는 질문

X Verified Followers API는 사용자 이름으로 X 계정의 체크 표시 팔로워를 계정당 최대 2,000개까지 수집하는 프로그래밍 인터페이스입니다. 각 행은 조회한 계정과 인증된 팔로워 하나를 연결하며, 팔로워의 id, 사용자 이름, 이름, 프로필 URL, 프로필 사진, 가입일을 담고 있습니다.

X에서는 프로필 팔로워 목록의 인증된 팔로워 탭에 표시됩니다. 여기에 해당 사용자 이름을 제출하면 같은 목록을 정렬, 필터링, 내보내기가 가능한 행으로 받을 수 있습니다.

X에서 인증 체크 표시가 있는 팔로워, 즉 X가 인증된 팔로워 탭에 보여 주는 계정입니다. 반환되는 모든 팔로워의 related_actor.is_verified 값은 true입니다.

네. 해당 사용자 이름으로 반환된 행 수를 세면 됩니다. 가장 넓게 보려면 results_limit 값을 2,000으로 설정하세요. 인증된 팔로워 목록이 그보다 긴 계정은 2,000행이 반환되므로 이 숫자는 최솟값으로 읽어야 합니다.

아니요. 행에는 팔로워의 id, 사용자 이름, 이름, 프로필 URL, 프로필 사진, 인증 여부, 가입일이 담깁니다. 팔로워 수나 소개가 필요하면 해당 사용자 이름을 Twitter Profile Scraper API에 전달하세요.

아니요. 여기서 published_at 값은 인증된 팔로워가 X에 가입한 날짜이며, 팔로우한 날짜는 결과에 포함되지 않습니다.