X Account Location
X의 '이 계정 정보'(About this account) 패널은 모든 프로필에 붙어 있는 짧은 기록으로, 계정이 기반을 둔 국가 또는 지역, 접속에 쓰는 앱 스토어·앱·웹 클라이언트, 가입일, 사용자 이름 변경 횟수, 제휴 조직이 담겨 있습니다. 이 정보를 함께 읽으면 계정이 콘텐츠에서 내세우는 지역에서 실제로 운영되는지 검증하고, 계약 전에 크리에이터를 검토하고, 뜻밖의 같은 출신지를 공유하는 계정 묶음을 찾아낼 수 있습니다.
X Account Location API 주요 기능
- 계정마다 X가 표시하는 국가country 필드에는 프로필의 '이 계정 정보' 패널에 있는 'Account based in' 값이 United States, United Kingdom처럼 그대로 들어 있습니다.
- 계정이 X에 접속하는 경로connected_via 필드는 X가 계정과 연결해 둔 채널(예: United States App Store, Android App, Web)을 나타내며, country 값과 나란히 놓고 볼 수 있습니다.
- 가입일과 핸들 변경 이력published_at 값은 계정이 X에 가입한 날짜이고 username_changes_count 값은 이름을 바꾼 횟수로, 핸들이 얼마나 자리 잡았는지 빠르게 보여 주는 두 가지 신호입니다.
- 제휴 배지와 신원 인증affiliate_username 필드는 프로필의 조직 배지(예: elonmusk의 X, BBCWorld의 BBCNews)를 보여 주며, is_identity_verified 값과 파란 체크 표시 여부인 is_verified 값이 함께 제공됩니다.
- 한 작업에서 사용자 이름마다 한 행사용자 이름 목록을 보내면(맨 앞의 @는 선택) 계정마다 id, username, name, avatar_url, is_private 값과 위치 정보가 담긴 별도의 행으로 돌아옵니다.
X Account Location API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
usernames | 필수 | 조회할 X 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다. 계정마다 별도의 행이 반환됩니다. |
X Account Location API 사용 방법
사용자 이름을 제출하고 계정마다 '이 계정 정보' 행 하나를 읽습니다.
- {"usernames": ["elonmusk", "BBCWorld"]}을 /v1/x/user-about로 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/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["elonmusk","BBCWorld"]}'
# An account that shows no country on X still returns a row, with country set to null.X Account Location API 추천 활용 사례
- 정치·뉴스 계정의 운영 지역 확인: 정치나 뉴스 이슈를 주도하는 핸들을 조회하고, country 또는 connected_via 값이 겨냥하는 독자층과 다른 지역을 가리키는 계정을 표시해 둡니다.
- 유료 협업 전 크리에이터 검증: country 값이 비용을 들여 공략하려는 시장과 일치하는지 확인하고, published_at과 username_changes_count 값을 보고 최근에 만들어졌거나 이름을 자주 바꾼 핸들인지 살핍니다.
- 조직적으로 움직일 수 있는 계정 묶기: 의심스러운 계정들을 country, connected_via, 가입 월 기준으로 묶어 같은 시기에 같은 곳에서 만들어진 계정 무리를 찾아냅니다.
- 대화에 참여한 계정의 국가 집계: 다른 X 엔드포인트로 모은, 게시물에 답글을 달거나 리포스트한 사용자 이름을 넣고 country 값을 집계해 논의가 어느 지역에서 나오는지 확인합니다.
X Account Location API 활용 팁
- 계정을 해외 운영 계정으로 판단하기 전에 country 값을 connected_via, published_at 값과 함께 읽으세요. 필드 하나만 보면 잘못 판단할 수 있습니다.
- username_changes_count 값에서 보듯 핸들은 자주 바뀔 수 있으므로, 계정은 id 기준으로 저장하세요.
- 행마다 collected_at 값을 함께 보관하고 나중에 같은 사용자 이름을 다시 조회하면 country, connected_via, username_changes_count 값의 변화를 잡아낼 수 있습니다.
- 반환된 행은 username 기준으로 입력 목록과 맞춰 보세요. 일부 계정을 찾지 못해도 나머지는 정상적으로 반환되며, 찾지 못한 계정은 행이 없을 뿐입니다.
관련 API
X Account Location API 외에 X의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- Twitter Profile Scraper API — 사용자 이름으로 공개 계정 정보, 소개글, 프로필 이미지, 커버 이미지, 계정 상태, 공개된 오디언스 통계를 가져옵니다.
- Twitter User Tweets Scraper API — 사용자 이름으로 최근 공개 게시물, 작성자, 미디어, 해시태그, 멘션, 참여도를 수집하며 답글은 제외합니다.
- X Followers List API — X 사용자 이름 하나 이상에 대해 공개 팔로워 계정 정보와 공개된 프로필 지표를 수집합니다.
- X Following List API — 공개 X 계정이 팔로우하는 프로필을 수집하며, 계정 정보, 소개글, 계정 신호, 공개된 카운터, 출처 사용자 이름을 포함합니다.
- X Post Retweeters API — 알고 있는 X 또는 Twitter 게시물 URL을 리포스트한 계정의 정규화된 공개 프로필을 작업 단위로 중복 없이 수집합니다.
- X Verified Followers API — 프로필을 팔로우하는 인증 계정을 사용자 이름, 표시 이름, 프로필 사진, 가입일과 함께 수집합니다.
- Twitter Tweet 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 Follow Checker API
- Twitter Video Transcript API