100 크레딧 무료, 카드 등록 없이

TikTok User Audience API

Name: TikTok User Audience API
Brand: SocialCrawl
Availability: InStock

API 한 번의 호출로 TikTok User Audience 데이터를 받아 가세요. Returns audience geography for a TikTok creator: audienceLocations ranks the top countries in the creator's audience with sampled follower counts and percentage share. Age and gender are not included: platforms do not expose those publicly.

2026년 8월 업데이트SocialCrawl 팀이 직접 관리해요

무료로 시작하기 문서 보기

크리에이터의 팔로워가 어느 나라에 있는지 돌려줍니다. 상위 국가와 표본 팔로워 수, 국가별 비중이 나옵니다.

오디언스 지역 분포만 필요할 때 사용하세요. 연령과 성별은 TikTok을 포함한 어떤 플랫폼에서도 공개로 제공되지 않습니다.

51개 플랫폼을 병렬로 검색합니다

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok API

User Audience API로 무엇을 할 수 있을까요

User Audience 엔드포인트가 통합 스키마와 계산 필드를 담은 TikTok 데이터를 한 번의 요청으로 보내드려요. 스크래핑 인프라를 직접 만들거나 유지할 필요가 없어요.

요청 예시

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/user/audience?handle=charlidamelio"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/tiktok/user/audience",
    params={
    'handle': 'charlidamelio',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()

const response = await fetch(
  "https://www.socialcrawl.dev/v1/tiktok/user/audience?handle=charlidamelio",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

파라미터

파라미터	필수	설명
handle	예	TikTok username without the @ symbol

응답 예시

TikTok User Audience API는 무엇을 돌려주나요

모든 응답은 하나의 통합 스키마를 따라요. 크레딧을 쓰기 전에 어떤 필드가 돌아오는지, 실제 응답 본문 그대로 확인해 보세요.

응답 예시 보기

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/user/audience",
  "data": {
    "audienceLocations": [
      {
        "country": "Mexico",
        "countryCode": "MX",
        "count": 127,
        "percentage": "28.22%"
      },
      {
        "country": "Brazil",
        "countryCode": "BR",
        "count": 40,
        "percentage": "8.89%"
      },
      {
        "country": "Philippines",
        "countryCode": "PH",
        "count": 36,
        "percentage": "8.00%"
      },
      {
        "country": "United States",
        "countryCode": "US",
        "count": 33,
        "percentage": "7.33%"
      },
      {
        "country": "Colombia",
        "countryCode": "CO",
        "count": 20,
        "percentage": "4.44%"
      },
      {
        "country": "Argentina",
        "countryCode": "AR",
        "count": 16,
        "percentage": "3.56%"
      },
      {
        "country": "Peru",
        "countryCode": "PE",
        "count": 14,
        "percentage": "3.11%"
      },
      {
        "country": "Venezuela",
        "countryCode": "VE",
        "count": 12,
        "percentage": "2.67%"
      },
      {
        "country": "Ecuador",
        "countryCode": "EC",
        "count": 10,
        "percentage": "2.22%"
      },
      {
        "country": "United Kingdom",
        "countryCode": "GB",
        "count": 8,
        "percentage": "1.78%"
      },
      {
        "country": "Dominican Republic",
        "countryCode": "DO",
        "count": 7,
        "percentage": "1.56%"
      },
      {
        "country": "Iraq",
        "countryCode": "IQ",
        "count": 7,
        "percentage": "1.56%"
      },
      {
        "country": "Chile",
        "countryCode": "CL",
        "count": 6,
        "percentage": "1.33%"
      },
      {
        "country": "Bolivia",
        "countryCode": "BO",
        "count": 6,
        "percentage": "1.33%"
      },
      {
        "country": "Costa Rica",
        "countryCode": "CR",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Guatemala",
        "countryCode": "GT",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Egypt",
        "countryCode": "EG",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Pakistan",
        "countryCode": "PK",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Honduras",
        "countryCode": "HN",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Germany",
        "countryCode": "DE",
        "count": 5,
        "percentage": "1.11%"
      },
      {
        "country": "Italy",
        "countryCode": "IT",
        "count": 4,
        "percentage": "0.89%"
      },
      {
        "country": "Saudi Arabia",
        "countryCode": "SA",
        "count": 4,
        "percentage": "0.89%"
      },
      {
        "country": "France",
        "countryCode": "FR",
        "count": 4,
        "percentage": "0.89%"
      },
      {
        "country": "Turkey",
        "countryCode": "TR",
        "count": 4,
        "percentage": "0.89%"
      },
      {
        "country": "Israel",
        "countryCode": "IL",
        "count": 3,
        "percentage": "0.67%"
      },
      {
        "country": "China",
        "countryCode": "CN",
        "count": 3,
        "percentage": "0.67%"
      },
      {
        "country": "Canada",
        "countryCode": "CA",
        "count": 3,
        "percentage": "0.67%"
      },
      {
        "country": "South Africa",
        "countryCode": "ZA",
        "count": 3,
        "percentage": "0.67%"
      },
      {
        "country": "El Salvador",
        "countryCode": "SV",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Bangladesh",
        "countryCode": "BD",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Australia",
        "countryCode": "AU",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Azerbaijan",
        "countryCode": "AZ",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Nigeria",
        "countryCode": "NG",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Spain",
        "countryCode": "ES",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Poland",
        "countryCode": "PL",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Ivory Coast",
        "countryCode": "CI",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Uganda",
        "countryCode": "UG",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Morocco",
        "countryCode": "MA",
        "count": 2,
        "percentage": "0.44%"
      },
      {
        "country": "Democratic Republic of the Congo",
        "countryCode": "CD",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Panama",
        "countryCode": "PA",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Algeria",
        "countryCode": "DZ",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Norway",
        "countryCode": "NO",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Uruguay",
        "countryCode": "UY",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Oman",
        "countryCode": "OM",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Afghanistan",
        "countryCode": "AF",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Jamaica",
        "countryCode": "JM",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Lebanon",
        "countryCode": "LB",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Belarus",
        "countryCode": "BY",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Benin",
        "countryCode": "BJ",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "United Arab Emirates",
        "countryCode": "AE",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Congo",
        "countryCode": "CG",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Portugal",
        "countryCode": "PT",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Kenya",
        "countryCode": "KE",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Kazakhstan",
        "countryCode": "KZ",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Netherlands",
        "countryCode": "NL",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Paraguay",
        "countryCode": "PY",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "New Zealand",
        "countryCode": "NZ",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Mali",
        "countryCode": "ML",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Belize",
        "countryCode": "BZ",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Bosnia and Herzegovina",
        "countryCode": "BA",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Ethiopia",
        "countryCode": "ET",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Greece",
        "countryCode": "GR",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Lithuania",
        "countryCode": "LT",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Croatia",
        "countryCode": "HR",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Ukraine",
        "countryCode": "UA",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Nicaragua",
        "countryCode": "NI",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Hungary",
        "countryCode": "HU",
        "count": 1,
        "percentage": "0.22%"
      },
      {
        "country": "Senegal",
        "countryCode": "SN",
        "count": 1,
        "percentage": "0.22%"
      }
    ]
  },
  "credits_used": 5,
  "credits_remaining": 9999,
  "request_id": "req-8Kq2ZmR4vT9xLb3P",
  "cached": false
}

통합 응답 구조를 보여 주는 실제 샘플이에요. 필드 값은 조회한 대상에 따라 달라져요.

API 상세

TikTok User Audience API는 어떻게 동작하나요

API 키와 함께 GET 요청을 보내면, 통합 스키마와 계산 필드를 담은 깔끔한 JSON이 돌아와요.

메서드

GET

응답 형식

JSON

왜 SocialCrawl인가요

TikTok User Audience 데이터는 왜 SocialCrawl로 가져올까요

TikTok 데이터 추출에서 까다로운 부분은 SocialCrawl이 가려 드려요. 통합 스키마, AI 인리치먼트, 그리고 코드에 남지 않는 플랫폼 로직까지.

모든 플랫폼이 같은 스키마라 연동은 한 번이면 끝이에요
엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때 참여율·예상 도달·카테고리·언어 같은 계산 필드도 함께 와요
스크래핑 인프라도, 프록시도, 속도 제한도 신경 쓰지 않아도 돼요
TikTok의 현재 공개 데이터를 돌려줘요. 엔드포인트별로 문서에 적힌 캐시 구간을 쓰고 적중하면 0크레딧이에요. Cache-Control: no-cache를 보내면 정상 요금으로 새로 조회해요

개발자 우선

소셜 미디어 데이터를 몇 초 만에 수집하는 방법

개발자를 위한 가장 빠른 소셜 미디어 스크래핑 API. 월간 활성 사용자 100억 명 이상을 포괄하는 51개 플랫폼에서 프로필, 게시물, 댓글, 분석 데이터를 수집하세요.

모든 플랫폼을 하나의 스키마로

동일한 응답 구조로 51개 플랫폼을 조회하세요. 연동은 한 번이면 충분합니다.

단순 수집을 넘어 계산된 필드 제공

엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때, 정규화된 레코드에 engagement_rate, estimated_reach, content_category, language를 함께 담아 바로 활용할 수 있습니다.

코드 한 줄 쓰기 전에, 데이터부터

Visual Data Explorer에 URL만 붙여넣으면 결과 카드와 정형화된 테이블, CSV 내보내기를 바로 사용할 수 있습니다.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 51개 플랫폼

자주 묻는 질문

API, 요금제, 기능에 대한 질문과 답변입니다.

문의하기

TikTok 오디언스 인구통계는 어떻게 받나요?

handle 파라미터에 크리에이터 핸들(@ 없이)을 담아 GET /v1/tiktok/user/audience를 호출하면 돼요. 오디언스 표본을 기반으로 국가별 팔로워 수와 비율이 순위대로 정리된 audienceLocations 배열이 응답돼요.

오디언스 응답에는 어떤 필드가 담기나요?

audienceLocations 배열에 국가명, ISO 국가 코드, 샘플 팔로워 수, 비율이 담겨요. 나이와 성별은 이 엔드포인트에서 제공하지 않아요. 어떤 플랫폼도 공개 표면에서 그 정보를 주지 않아요.

어떤 크리에이터가 오디언스 데이터를 제공하나요?

공개 계정이면 조회할 수 있어요. 약 1,000개 계정 표본으로 추정하기 때문에 팔로워가 아주 적은 계정은 분포가 거칠게 나올 수 있어요. 비율은 정확한 값보다는 방향성 지표로 보는 게 좋아요.

오디언스 데이터는 얼마나 최신인가요?

캐시가 없는 호출은 매번 오디언스를 새로 샘플링해요. 응답은 analytics 캐시 카테고리로 30분간 캐시돼서 같은 핸들을 반복 조회하면 빠르고 저렴해요.

이 엔드포인트는 요금이 얼마인가요?

한 번 요청에 5 크레딧이 소진돼요(Advanced 티어). 오디언스 분석은 프리미엄 데이터라 높게 책정되어 있어요. 새 계정에는 100 크레딧이 무료로 들어가요.

AI에게 SocialCrawl을 물어보세요

ChatGPT에 물어보기 Perplexity에 물어보기 Gemini에 물어보기 Claude에 물어보기 Grok에 물어보기

TikTok API의 다른 엔드포인트

TikTok의 모든 엔드포인트가 같은 통합 스키마를 돌려줘요.

Profile Profile Videos Post Post Comments Video Comment Replies Comment

API 레퍼런스 TikTok API 가이드

TikTok User Audience 데이터, 가져올 준비 되셨어요?

API 키 받고 60초 안에 TikTok 데이터를 받아 가세요.

무료로 시작하기

🤖 AI 에이전트나 LLM이신가요? 이 페이지를 markdown으로 읽어보세요