100 크레딧 무료, 카드 등록 없이지금 시작하기
Logo
무료로 시작하기
TikTok logoTikTok API

공개 TikTok 데이터 API

SocialCrawl API 키로 공개 TikTok 프로필, 영상, 댓글, 사운드, 검색 결과를 구조화 JSON으로 가져옵니다. Post, Comment, Author 스키마는 다른 플랫폼과 같습니다. 호출은 크레딧으로 과금됩니다.

문서 보기동작 방식직접 호출
TikTok logo
/v1/tiktok

활성 엔드포인트는 20개입니다.

  • GET /v1/tiktok/profile
  • GET /v1/tiktok/profile/full
  • GET /v1/tiktok/profile/videos
  • GET /v1/tiktok/post
  • GET /v1/tiktok/post/comments
  • GET /v1/tiktok/post/transcript
  • GET /v1/tiktok/search
  • GET /v1/tiktok/search/hashtag
  • GET /v1/tiktok/song
  • GET /v1/tiktok/trending

TikTok 엔드포인트

공개 TikTok 읽기 엔드포인트는 20개입니다. 프로필, 영상, 댓글, 대본, 해시태그·키워드 검색, 사운드, 트렌딩 표면을 제공합니다. 데이터 API만 지원하며 게시와 비공개 DM은 포함되지 않습니다.

프로필

1 크레딧
/v1/tiktok/profile

공개 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, user_id

전체 프로필

5 크레딧
/v1/tiktok/profile/full

공개 전체 프로필 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, user_id, posts, cursor

프로필 영상

1 크레딧
/v1/tiktok/profile/videos

공개 프로필 영상 정보를 반환합니다. 표시 이름, 소개, 카운터, URL이 포함됩니다.

handle, user_id, sort_by, max_cursor, region

게시물

1 크레딧
/v1/tiktok/post

공개 게시물 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

url, region, trim, download_media

게시물 댓글

1 크레딧
/v1/tiktok/post/comments

공개 댓글 데이터를 반환합니다. 작성자, 본문, 참여 지표가 포함됩니다.

url, cursor, trim

게시물 대본

10 크레딧
/v1/tiktok/post/transcript

공개 대본 또는 자막 데이터를 반환합니다. 없으면 환불될 수 있습니다.

url, language, use_ai_as_fallback

검색

1 크레딧
/v1/tiktok/search

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

query, date_posted, sort_by, region, cursor

해시태그 검색

1 크레딧
/v1/tiktok/search/hashtag

공개 검색 결과를 반환합니다. 제목, 스니펫 또는 게시물 행이 포함됩니다.

hashtag, region, cursor, trim

사운드

1 크레딧
/v1/tiktok/song

공개 사운드 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

clipId

트렌딩

5 크레딧
/v1/tiktok/trending

공개 트렌딩 데이터를 반환합니다. 본문, 참여 지표, 작성자 필드가 포함됩니다.

region, trim

TikTok API33개 엔드포인트 지원
문서 보기

TikTok 계정의 공개 프로필을 돌려줍니다: 표시 이름, 소개, 원본이 주는 그대로의 정수 팔로워 수(author.followers; 공개된 반올림 숫자만 있을 때는 author.ext.followers_approximate가 true), 좋아요 수, 인증 여부, 숫자 user id.

handle만 아는 상태에서 영상이나 팔로워를 가져오기 전에 계정을 빠르게 훑어볼 때 사용하세요.

1크레딧

GET/v1/tiktok/profile?handle=charlidamelio
$ curl https://www.socialcrawl.dev/v1/tiktok/profile?handle=charlidamelio \
    -H "x-api-key: sc_YOUR_API_KEY"
대기 중
// 파라미터를 수정한 뒤 "실행해보기"를 누르면 실제 응답을 받습니다

TikTok API 동작 방식

TikTok도 다른 SocialCrawl 소셜 엔드포인트와 같습니다. API 키로 GET /v1/tiktok/… 를 호출하고 캐시 미스에 크레딧을 쓰며 동일한 JSON 봉투를 받습니다. TikTok 개발자 앱과 별도 SDK는 없습니다.

호출 인증

x-api-key 헤더에 키를 보냅니다. SocialCrawl 카탈로그 전 구간에 같은 키를 사용합니다.

GET과 쿼리 파라미터

라우트는 GET입니다. handle, url, query, cursor를 쿼리로 전달합니다. 과금 전에 형식을 검증합니다.

크레딧 과금

라이브 미스는 라우트 티어를 차감합니다. 캐시 히트는 0입니다. 빈 응답과 하드 실패는 환불됩니다.

JSON 봉투

응답 형태는 success, data, credits_used, credits_remaining, request_id, cached로 동일합니다.

연동 순서

대부분 제품은 매 틱마다 전 엔드포인트를 호출하지 않습니다. 핸들을 확인한 뒤 영상을 보고 필요한 게시물만 깊게 읽습니다.

01프로필
GET /v1/tiktok/profile

Author 형태 계정입니다. 소개, 팔로워, 좋아요, user id가 포함됩니다.

콘텐츠 목록 전에 핸들을 한 번 확정합니다.

02영상 목록
GET /v1/tiktok/profile/full

최근 공개 영상의 PostList입니다.

cursor로 페이지를 넘깁니다. trim으로 페이로드를 줄일 수 있습니다.

03영상 본문
GET /v1/tiktok/profile/videos

사운드와 영상 메타데이터를 포함한 전체 Post입니다.

검색 제목만으로는 영상 레코드가 부족할 때 사용합니다.

04댓글
GET /v1/tiktok/post

영상 하나당 CommentList 페이지입니다.

스레드가 중요하면 video/comment/replies로 답글을 펼칩니다.

요청
GET /v1/tiktok/profile
  ?handle=example
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here
응답 봉투
{
  "success": true,
  "data": { "/* Author | Post | PostList | CommentList | … */": true },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

data 형태

archetype이 맞으면 필드 이름은 SocialCrawl 나머지 플랫폼과 같습니다.

Authorprofile

id, username, display_name, avatar_url, bio, followers, 참여 합계, url, ext

PostList / Postprofile/full

items[].post에 id, url, content, engagement(조회·좋아요·댓글·공유), author, published_at, 사운드·미디어 ext

CommentListprofile/videos

items[]에 author, content.text, engagement, published_at. 더 있으면 cursor

Transcript / Analyticspost

자막 또는 AI 대체 대본. profile/full 참여 요약

게이트웨이 내부

다른 /v1 플랫폼 엔드포인트와 같은 요청 수명 주기입니다.

  1. 01

    엣지 수신

    Next.js catch-all이 Hono 소셜 API로 연결됩니다. request_id를 발급하고 키를 인증한 뒤 속도 제한과 동시성을 적용합니다.

  2. 02

    검증 후 차감

    레지스트리에서 라우트를 찾습니다. 필수 파라미터를 먼저 검사합니다. 잘못된 입력은 미과금 400입니다. 유효 호출은 upstream 전에 차감합니다.

  3. 03

    캐시 또는 수집

    platform + resource + params로 캐시 키를 만듭니다. 히트는 credits_used 0입니다. 미스는 재시도와 서킷 브레이커로 upstream을 호출합니다.

  4. 04

    정규화 후 반환

    upstream JSON을 Author / Post / PostList / CommentList(또는 라우트 archetype)로 매핑하고 검증한 뒤 성공 봉투로 감싸 과금 감사 로그를 남깁니다.

운영에서 중요한 과금 규칙

  • 표준 라이브 미스: 티어 비용(보통 1 크레딧)
  • 고급 읽기: 보통 5 크레딧
  • 프리미엄 읽기: 보통 10 크레딧
  • 종량제 라우트: 문서화된 최소 바닥
  • 캐시 히트: 0 크레딧
  • 빈 응답·하드 실패: 자동 환불
  • 잘못된 파라미터: 400, 미과금
  • 크레딧 부족: 402, 미과금
  • 비활성 라우트: 503, 미과금

데이터 수집 방식

TikTok은 공개 읽기 소셜 데이터입니다. SocialCrawl 스키마로 정규화하므로 별도 OAuth나 원본 upstream 형태를 배울 필요가 없습니다.

이 API에서의 TikTok

공개 프로필, 영상, 댓글, 사운드, 검색입니다. 연구·모니터링·제품 작업을 위한 읽기 전용 표면입니다. 게시와 비공개 수신함은 포함되지 않습니다.

SocialCrawl 접근 방식

공개 엔드포인트를 요청 시점에 실시간으로 읽어 엣지에서 정규화한 뒤 전달합니다. profile/full 같은 Prism 컴포지트는 여러 단계를 한 호출로 묶습니다.

엣지에서 나가는 형태

success, data, credits_used, request_id, cached 통일 JSON 봉투입니다. 프로필은 Author, 게시물과 댓글은 다른 플랫폼과 같은 리프입니다.

제공하지 않는 범위

쓰기 엔드포인트와 비공개 메시지는 없습니다. 비활성 라우트는 활성 개수에 넣지 않습니다. 최신 목록은 레지스트리 문서를 따릅니다.

필드 매핑
public profile / channel→ author.*handle, bio, 팔로워, 좋아요 합계
public post / media→ post.* / items[].post캡션, 조회, 좋아요, 댓글, 사운드
comment page / tree→ CommentList items[]댓글 본문, 좋아요, 답글 수, cursor

이 API의 활용 분야

이 API가 가장 많이 사용되는 작업입니다.

20active TikTok endpoints in the registry
1 / 5 / 10표준·고급·프리미엄 읽기 크레딧 단계

크리에이터 모니터링과 숏폼 콘텐츠 분석

호출은 프로필-영상 체인, 키워드·해시태그 검색, 급등 영상의 댓글 확장에 집중됩니다. 공유 스키마의 구조화 TikTok JSON, 필요 시 대본, 카탈로그 전 구간 동일 키입니다.

프로필과 게시물 상세는 캐시 미스 기준 수 초 수준입니다. 검색과 두꺼운 프로필 컴포지트는 더 느린 소셜 읽기 경로입니다.

TikTok API 활용 사례

TikTok 데이터가 가장 많이 쓰이는 작업입니다. 각 항목에서 엔드포인트 순서와 과금 방식을 확인합니다.

활용 사례

이 데이터를 활용하는 대표적인 방식과 각 방식에서 주로 사용하는 스택입니다.

크리에이터 운영

Python, cron, Slack 봇

고정 핸들 집합에 profile/videos를 폴링합니다. 조회수나 댓글 속도가 뛰면 알립니다.

브랜드·VoC 팀

Node, 노트북, BI 적재

해시태그·키워드 검색 후 post와 댓글을 확장해 제품·경쟁 언어를 모읍니다.

백엔드 제품 잡

Go, 워커, Explorer

프로필-영상-게시물-댓글을 파이프라인에 연결합니다. 캐시 히트로 반복 비용을 낮춥니다.

두 줄로 호출

대부분 표준 읽기는 라이브 호출당 1 크레딧입니다. 캐시 히트는 무료입니다. 고급·프리미엄 단계는 더 높습니다.

curl "https://www.socialcrawl.dev/v1/tiktok/profile?handle=example" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/tiktok/profile/full?handle=example" \
  -H "x-api-key: sc_your_api_key_here"
TikTok logoSocialCrawl의 TikTok

카탈로그 전 구간과 같은 키

플랫폼 문서API 키 받기
엔드포인트

TikTok API는 어떤 데이터를 돌려주나요

모든 엔드포인트가 같은 응답 구조의 JSON을 보내드려요. 엔드포인트가 해당 지표를 지원하고 계산에 필요한 원본 값이 있을 때만 참여율·콘텐츠 카테고리 같은 계산 필드가 포함돼요.

ProfileGet TikTok user profileProfile VideosList TikTok user videosPostGet TikTok post detailsPost CommentsList TikTok post commentsVideo Comment RepliesList TikTok comment repliesCommentLook up one TikTok comment by URL or idSearchSearch TikTok videos by keywordTrendingGet TikTok trending feedSearch HashtagSearch TikTok by hashtagSearch TopTikTok top search resultsSearch UsersSearch TikTok usersUser AudienceGet TikTok user audience demographicsUser FollowersList TikTok user followersUser FollowingList TikTok user followingUser LiveGet TikTok user live streamPost TranscriptGet TikTok video transcriptVideo Screen TextGet TikTok video on-screen textSongGet TikTok song detailsSong VideosList TikTok videos using a songProfile RegionGet TikTok profile regionAdlibrary SearchSearch the TikTok Ad LibraryAdlibrary AdGet a TikTok Ad Library adSearch SuggestionsGet TikTok search suggestionsCollection VideosList videos in a TikTok collectionProfile PlaylistsList a TikTok account's playlistsPlaylist VideosList videos in a TikTok playlistUser LikedList the videos a TikTok account has likedLocation PostsList TikTok videos tagged at a placeEffectsGet TikTok effects by idEffect VideosList TikTok videos made with an effectSearch MusicSearch TikTok soundsHashtagGet TikTok hashtag detailsProfile FullTikTok profile, recent posts, and computed analytics in one call.
비교

SocialCrawl과 공식 TikTok API, 뭐가 다른가요?

같은 TikTok 데이터를 받는 두 가지 방법을 나란히 비교했어요. 인증부터 비용까지 한눈에 확인해 보세요.

인증

SocialCrawl
x-api-key 헤더 하나면 돼요
공식 TikTok API
OAuth 2.0 토큰 발급과 사용자 승인이 필요해요

시작과 심사

SocialCrawl
가입하고 1분 안에 바로 호출할 수 있어요
공식 TikTok API
개발자 앱 등록과 심사를 먼저 통과해야 해요

요청 한도

SocialCrawl
일일 쿼터 걱정 없이 쓴 만큼 크레딧으로 결제해요
공식 TikTok API
앱 단위로 일일 쿼터가 정해져 있어요

데이터 범위

SocialCrawl
공개 프로필, 영상, 댓글, 검색, 트렌딩, 음원, 트랜스크립트, 오디언스 데이터까지 받아볼 수 있어요
공식 TikTok API
승인받은 사용자 데이터 위주이고, Research API는 연구 기관 중심이에요

응답 스키마

SocialCrawl
51개 플랫폼이 같은 통합 JSON 스키마를 써요
공식 TikTok API
엔드포인트마다 TikTok 전용 구조예요

요금

SocialCrawl
요청당 1 크레딧부터, 100 크레딧 무료로 시작해요
공식 TikTok API
승인된 쿼터 안에서는 무료예요

유지보수

SocialCrawl
TikTok 화면이 바뀌어도 통합 스키마가 그대로 유지돼요
공식 TikTok API
공식 지원과 버전 관리, 게시물 업로드 기능은 공식 API의 강점이에요
자주 묻는 질문

자주 묻는 질문

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

문의하기
TikTok 데이터를 API로 어떻게 수집하나요?
x-api-key 헤더와 함께 GET 요청을 보내면 돼요. SocialCrawl의 33개 TikTok 엔드포인트가 모두 통합 스키마 JSON으로 응답해 드리고, engagement_rate와 estimated_reach 같은 AI 보강 필드도 함께 받아볼 수 있어요.
TikTok API는 어떤 데이터를 다루나요?
33개 엔드포인트로 다룰 수 있어요: Profile, Profile Videos, Post, Post Comments, Video Comment Replies, Comment, Search, Trending, Search Hashtag, Search Top, Search Users, User Audience, User Followers, User Following, User Live, Post Transcript, Video Screen Text, Song, Song Videos, Profile Region, Ad Library Search, Ad Library Ad, Search Suggestions, Collection Videos, Profile Playlists, Playlist Videos, User Liked, Location Posts, Effects, Effect Videos, Search Music, Hashtag, and Profile Full. TikTok Shop 엔드포인트는 별도의 TikTok Shop 플랫폼에서 제공해요.
TikTok API는 요금이 얼마인가요?
대부분 엔드포인트는 한 번 요청에 1 크레딧이 소진돼요(스탠다드 티어). 트렌딩 피드나 오디언스 분석 같은 Advanced 엔드포인트는 5 크레딧이에요. 새 계정에는 100 크레딧이 무료로 들어가서 신용카드 없이 약 100건을 받아볼 수 있어요.
TikTok 데이터를 수집하는 게 법적으로 괜찮나요?
SocialCrawl은 브라우저로 누구나 볼 수 있는 TikTok 공개 데이터만 가져와요. 다만 사용 목적이 TikTok 약관과 GDPR·CCPA 같은 개인정보 법령에 부합하는지는 직접 확인해 주세요. SocialCrawl은 GDPR 정당한 이익에 기반한 문서화된 프레임워크로 운영돼요. 로그인 없이 볼 수 있는 공개 데이터만 다루고, 계정 자격 증명은 일절 사용하지 않으며, 캐시는 2~30분만 유지되고 영구 저장하지 않아요. 자신의 공개 정보에 대한 옵트아웃 채널도 운영해요. 자세한 내용은 socialcrawl.dev/legal/public-data-notice에서 확인하실 수 있어요.
프로덕션에서도 TikTok API를 써도 되나요?
네, 33개 엔드포인트 모두 통합 스키마로 정리되어 있어서 TikTok이 UI나 응답 구조를 바꿔도 코드가 깨지지 않아요. 부하가 걸려도 응답 속도가 일정하고 업스트림 자동 재시도까지 적용돼요.
TikTok Shop 데이터도 받아볼 수 있나요?
네, TikTok Shop 전용 엔드포인트 다섯 종을 제공해요. shop/product, shop/product/reviews, shop/products, shop/search, user/showcase에서 가격, 평점, 리뷰, 판매자 정보를 통합 스키마로 받아볼 수 있어요.
TikTok 스크래핑 API는 어떤 걸 쓰는 게 좋아요?
공개 데이터 수집이 목적이라면 SocialCrawl이 잘 맞아요. 프로필, 영상, 댓글, 검색, 트렌딩, 음원, 트랜스크립트까지 33개 엔드포인트를 x-api-key 하나로 호출할 수 있고, 요청당 1 크레딧부터 시작해요. 가입하면 신용카드 없이 100 크레딧을 무료로 받아요. 게시물 업로드 같은 쓰기 작업이 필요하다면 공식 TikTok API가 맞아요.
TikTok 스크래핑 API와 공식 TikTok API는 뭐가 다른가요?
SocialCrawl은 앱 심사나 승인 대기가 없어요. 가입 직후 x-api-key 하나로 TikTok 엔드포인트를 바로 호출할 수 있고, 응답은 다른 모든 플랫폼과 같은 통합 스키마로 와요. 요금도 플랫폼별 쿼터 대신 크레딧으로 계산해요. 글 게시 같은 쓰기 작업이 필요하다면 공식 API가 맞아요. SocialCrawl은 읽기 전용 데이터만 다뤄요.

AI에게 SocialCrawl을 물어보세요

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

TikTok API 레퍼런스 문서 보기

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