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 사용 방법
계정 하나와 비교할 계정들을 제출하고 쌍마다 행 하나를 읽습니다.
- {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]}을 /v1/x/check-follow로 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/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 값을 저장하고 나중에 같은 확인을 다시 실행하세요. 결과를 비교하면 새로 팔로우하거나 언팔로우한 계정이 드러납니다.
관련 API
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 접속 방식, 가입일, 사용자 이름 변경 횟수를 확인합니다.
- 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 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 Video Transcript API