tiktok/
user-audience

공개 TikTok 계정의 팔로워가 어느 나라에 사는지 사용자 이름만으로 확인하고, 국가별 이름, ISO 코드, 오디언스 비중, 표본 팔로워 수를 반환합니다.

TikTok Audience Demographics API

사용자 이름 입력
팔로워 국가
국가별 비중
요청당 20 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Audience Demographics

TikTok 계정의 오디언스 국가는 팔로워가 어느 나라에 모여 있는지를 보여 주며, 팔로워 표본에서 각 국가가 차지하는 비중과 그 비중의 근거가 된 표본 팔로워 수로 나타냅니다. TikTok 자체 분석은 이 화면을 계정 주인에게만 열어 주기 때문에, 직접 운영하지 않는 크리에이터를 살펴봐야 하는 브랜드·에이전시·분석가는 사용자 이름으로 조회합니다.

TikTok Audience Demographics API 주요 기능

  • 로그인 없이 공개 계정 조회@ 유무와 관계없이 공개 사용자 이름만 보내면 됩니다. 계정 접근 권한이나 TikTok 세션 없이도 팔로워 지역 분포를 받을 수 있습니다.
  • 국가명, ISO 코드, 비중, 인원 수audience_countries 항목마다 국가명, 두 글자 country_code, 0에서 1 사이의 비중, 그 비중의 근거가 된 표본 팔로워 수가 들어 있습니다.
  • 큰 시장부터 정렬국가가 비중 순으로 내려오므로 앞쪽 몇 줄만 봐도 오디언스 대부분이 어디에 있는지 알 수 있고, 뒤쪽에서는 규모가 작은 시장을 확인할 수 있습니다.

TikTok Audience Demographics API 매개변수

매개변수필수설명
username필수분석할 TikTok 사용자 이름이며, 맨 앞의 @는 있어도 없어도 됩니다.

TikTok Audience Demographics API 사용 방법

사용자 이름을 제출하고 작업을 폴링한 뒤, 오디언스 레코드 1건을 읽습니다.

  1. {"username": "khaby.lame"}를 /v1/tiktok/user-audience로 POST합니다.
  2. status가 succeeded가 될 때까지 몇 초 간격으로 GET /v1/tasks/{task_id}를 폴링합니다.
  3. results.items의 레코드 1건을 읽고 audience_countries를 순서대로 훑습니다.
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"khaby.lame"}'

# The result has one record; audience_countries[].share is a fraction from 0 to 1.

TikTok Audience Demographics API 추천 활용 사례

  • 특정 시장을 겨냥한 크리에이터 섭외: 한 국가만 노리는 캠페인에 비용을 쓰기 전에, 그 국가가 크리에이터 팔로워에서 차지하는 비중부터 확인하세요. 팔로워가 많아도 다른 나라에 살고 있다면 구매 고객에게 닿지 않습니다.
  • 지역 타깃 확장이 먹히는지 점검: 새로운 국가에서 오디언스를 키우는 중이라면 같은 사용자 이름을 주기적으로 조회해, collected_at 시점별로 해당 국가의 비중이 어떻게 달라지는지 비교합니다.
  • 서비스할 수 없는 시장 걸러내기: 정해진 국가에만 판매하는 쇼핑몰이나 앱이라면 해당 country_code의 비중을 합산해, 팔로워 대부분이 그 밖에 사는 크리에이터를 후보에서 뺄 수 있습니다.

TikTok Audience Demographics API 활용 팁

  • count를 share로 나누면 팔로워 표본의 크기를 가늠할 수 있습니다. 표본이 작으면 비중이 비슷한 국가끼리는 순위를 매기지 말고 동률로 보세요.
  • 크리에이터를 비교하기 전에 country_code를 EU, LATAM처럼 직접 정한 권역으로 묶으세요. 캠페인은 보통 한 나라보다 권역 단위로 집행됩니다.

TikTok Audience Demographics API 외에 TikTok의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

  • TikTok Profiles API — 사용자 이름으로 공개 프로필 정보, 소개글, 계정 속성, 오디언스 수치를 가져옵니다.
  • TikTok Followers List API — 공개 팔로워 목록에 표시되는 프로필을 정규화해 수집하며, 출처 맥락과 지원되는 지표를 유지합니다.
  • TikTok Following List API — TikTok 계정이 팔로우하는 공개 프로필을 수집하며, 정규화된 계정 정보, 소개글, 공개된 지표, 출처 계정 맥락을 포함합니다.
  • TikTok User Videos API — 사용자 이름으로 공개 프로필 피드 동영상을 수집하며, 캡션, 크리에이터, 미디어, 타임스탬프, 참여도, 출처 계정 맥락을 포함합니다.
  • TikTok Similar Accounts API — TikTok이 사용자 이름과 비슷하다고 추천하는 계정을 찾으며, 팔로워 수와 소개를 포함합니다.
  • TikTok Live Ranking API — 일간 LIVE 크리에이터 순위를 순위, 선물 기반 점수, 팔로워 수와 함께 가져옵니다.

다른 플랫폼 둘러보기

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

TikTok Audience Demographics API — 자주 묻는 질문

TikTok Audience Demographics API는 사용자 이름으로 공개 TikTok 계정의 팔로워가 위치한 국가를 조회하는 프로그래밍 인터페이스입니다. 국가별 이름, ISO 코드, 오디언스 비중, 표본 팔로워 수가 담긴 레코드 1건을 반환합니다.

공개 계정이면 모두 가능합니다. TikTok은 팔로워 지역을 계정 주인에게만 보여 주지만, 이 조회는 사용자 이름만 있으면 됩니다.

아니요. 레코드에는 팔로워 국가만 들어 있고 연령, 성별, 도시별 구분은 없습니다.

네, 본인 사용자 이름을 보내면 국가 분포를 데이터로 받을 수 있습니다. TikTok 분석 화면을 하나씩 열어 보지 않아도 되므로, 운영 중인 여러 계정의 보고서를 만들 때 편리합니다.

비중은 계정 팔로워 표본에서 계산되며, count가 그 비중 뒤에 있는 표본 팔로워 수를 알려 줍니다. count가 작은 국가는 정확한 수치가 아니라 대략적인 신호로 보세요.

요청 단위입니다. 사용자 이름 하나당 국가가 몇 개 오든 20 크레딧이 일정하게 차감되며, 존재하지 않는 사용자 이름이면 작업이 실패 처리되고 크레딧이 반환됩니다.