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 사용 방법
사용자 이름을 제출하고 각각 수집할 인증된 팔로워 수를 정한 뒤 행을 페이지 단위로 읽습니다.
- {"usernames": ["NASA"], "results_limit": 100}을 /v1/x/verified-followers로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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 필드에 들어 있습니다.
관련 API
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 — 한 계정이 다른 계정들을 팔로우하는지, 상대가 맞팔로우하는지 확인합니다.
- 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 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 Video Transcript API