x/
check-follow

X 계정 하나가 최대 100개 계정을 팔로우하는지, 각 계정이 맞팔로우하는지 확인하고, 사용자 이름 쌍마다 is_following, is_followed_by, is_mutual 값을 반환합니다.

Twitter Follow Checker API

양방향 팔로우
작업당 최대 100쌍
맞팔로우 표시
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

Twitter Follow Checker

X(구 트위터)의 팔로우는 한 계정에서 다른 계정으로 향하는 단방향 연결이므로, 두 계정의 관계는 서로 팔로우하지 않음, 첫 번째가 두 번째를 팔로우함, 두 번째가 첫 번째를 팔로우함, 서로 팔로우함의 네 가지 중 하나입니다. 계정 쌍이 어느 상태인지 알면 이벤트 응모자가 브랜드를 팔로우하는지, 파트너가 맞팔로우했는지, 크리에이터 그룹이 얼마나 촘촘하게 연결되어 있는지 같은 일상적인 질문에 답할 수 있습니다.

Twitter Follow Checker API 주요 기능

  • 계정 하나를 최대 100개 계정과 비교확인할 계정을 username에, 최대 100개 계정을 usernames 배열에 넣으면 쌍마다 source_username, target_username 값이 담긴 별도의 행으로 반환됩니다.
  • 양방향 결과와 맞팔로우 여부를 한 행에is_following 값은 username 계정이 상대를 팔로우하는지, is_followed_by 값은 상대가 맞팔로우하는지 알려 주며, 둘 다 해당하면 is_mutual 값이 true입니다.
  • 쌍 키와 프로필 링크id 값은 source_username:target_username 형식이고 url 값은 상대 프로필을 가리키므로, 행을 내 목록과 깔끔하게 연결하고 클릭 한 번으로 열 수 있습니다.

Twitter Follow Checker API 매개변수

매개변수필수설명
username필수확인할 X 계정이며, usernames 배열의 모든 계정과 비교됩니다.
usernames필수username 계정과 비교할 X 사용자 이름으로 최대 100개까지 넣습니다. 계정마다 해당 쌍의 행이 반환됩니다.

Twitter Follow Checker API 사용 방법

계정 하나와 비교할 계정들을 제출하고 쌍마다 행 하나를 읽습니다.

  1. {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}을 /v1/x/check-follow로 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/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'

# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.

Twitter Follow Checker API 추천 활용 사례

  • 경품 이벤트 응모자의 팔로우 조건 확인: 브랜드 계정을 username에, 응모자를 최대 100명까지 usernames 배열에 넣은 뒤 is_followed_by 값이 true인 응모자만 남깁니다.
  • 맞팔로우를 기다리는 파트너 찾기: 내가 팔로우하는 크리에이터나 브랜드와 내 계정을 비교하고, is_following 값은 true이고 is_followed_by 값은 false인 쌍을 정리합니다.
  • 크리에이터 그룹 내 연결 관계 파악: 그룹 멤버를 차례로 username에 넣고 나머지 멤버와 비교한 뒤, is_mutual 값으로 누가 누구와 연결되어 있는지 그립니다.
  • 주요 계정이 팔로우하는 경쟁 브랜드 관찰: 경영진이나 기자의 계정을 경쟁사 목록과 비교하고, 나중에 다시 확인해 is_following 값이 언제 바뀌는지 봅니다.

Twitter Follow Checker API 활용 팁

  • 100개가 넘는 목록은 중복을 제거하고 100개씩 나눠 보낸 뒤 결과를 id로 합치세요.
  • 행이 반환되지 않은 대상은 미확인으로 기록하고 false로 보고된 쌍과 구분해 두세요. 행은 찾은 계정에 대해서만 생성됩니다.
  • 쌍마다 collected_at 값을 저장하고 나중에 같은 확인을 다시 실행하세요. 결과를 비교하면 새로 팔로우하거나 언팔로우한 계정이 드러납니다.

Twitter Follow Checker 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 Community API — 커뮤니티 링크에서 소개, 멤버 수, 규칙, 가입 정책을 가져옵니다.
  • X Account Location API — 계정의 기반 국가, X 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.

다른 플랫폼 둘러보기

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

Twitter Follow Checker API — 자주 묻는 질문

Twitter Follow Checker API는 사용자 이름만으로 X 계정 하나와 최대 100개 계정 사이의 팔로우 관계를 확인하는 프로그래밍 인터페이스입니다. 쌍마다 첫 번째 계정이 두 번째를 팔로우하는지, 맞팔로우를 받는지, 서로 팔로우하는지를 반환합니다.

첫 번째 계정을 username에, 두 번째 계정을 usernames 배열에 넣으세요. is_following 값은 첫 번째가 두 번째를 팔로우하는지, is_followed_by 값은 그 반대를 같은 행에서 알려 줍니다.

내 핸들을 username에, 상대 핸들을 usernames 배열에 넣으세요. is_followed_by 값이 true면 상대가 나를 팔로우한다는 뜻이며, 작업 하나로 최대 100개 계정을 확인할 수 있습니다.

is_mutual 값을 보세요. 두 계정이 서로 팔로우할 때만 true입니다.

username 계정 하나를 usernames 배열의 최대 100개 계정과 비교하며, 쌍마다 행 하나가 반환됩니다. 더 긴 목록은 여러 작업으로 나누세요.

확인은 사용자 이름으로 공개 계정을 대상으로 실행됩니다. 보호된 계정은 X에서 팔로우 목록이 숨겨져 있으므로 이 계정이 포함된 쌍은 확인할 수 없습니다.

이 엔드포인트는 제출한 쌍만 보고하므로 전체 목록은 볼 수 없습니다. 전체 목록이 필요하면 X Following List API나 X Followers List API를 사용하세요.