x/
user-about

사용자 이름으로 X가 계정에 표시하는 국가 또는 지역을 조회하고, X 접속 경로, 가입일, 사용자 이름 변경 횟수, 제휴 배지도 함께 확인합니다.

X Account Location API

계정 기반 국가
접속 경로
사용자 이름 일괄 조회
결과당 0.7 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

사용자 이름을 제출하고 계정마다 '이 계정 정보' 행 하나를 읽습니다.

  1. {"usernames": ["elonmusk", "BBCWorld"]}을 /v1/x/user-about로 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/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 기준으로 입력 목록과 맞춰 보세요. 일부 계정을 찾지 못해도 나머지는 정상적으로 반환되며, 찾지 못한 계정은 행이 없을 뿐입니다.

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 — 프로필을 팔로우하는 인증 계정을 사용자 이름, 표시 이름, 프로필 사진, 가입일과 함께 수집합니다.

다른 플랫폼 둘러보기

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

X Account Location API — 자주 묻는 질문

X Account Location API는 사용자 이름 목록으로 X 계정의 '이 계정 정보' 내용을 읽어 오는 프로그래밍 인터페이스입니다. 계정마다 기반 국가 또는 지역, X 접속 경로, 가입일, 사용자 이름 변경 횟수, 제휴 배지, 인증 여부를 반환합니다.

X는 프로필의 '이 계정 정보' 패널에 'Account based in' 항목으로 이를 표시합니다. 여기에 사용자 이름을 제출하면 같은 값이 country 필드로 들어오므로, 한 작업에서 여러 계정을 확인할 수 있습니다.

계정이 어디를 통해 X에 접속하는지를 나타내며, 특정 국가의 App Store, Android 앱, 웹 등이 해당합니다. 이 엔드포인트는 이 값을 connected_via 필드로 반환합니다.

NASA 같은 정부·공익 계정을 비롯해 일부 계정에는 X가 국가를 표시하지 않습니다. 이런 계정도 다른 필드가 채워진 행으로 반환되며 country 값만 null입니다.

X가 '이 계정 정보' 패널에 직접 표시하는 값을 그대로 반환한 것입니다. X가 계정의 기반을 어디로 보는지 알려 주는 X의 표기이며, 계정 뒤에 있는 사람의 실시간 위치는 아닙니다.

아니요. 사용자가 프로필에 직접 입력하는 자유 형식 위치는 별도 필드이며, Twitter Profile Scraper API가 location 필드로 반환합니다.