API 목록으로 돌아가기
TikTok 공개 데이터

TikTok 공개 데이터 API

지원하는 공개 TikTok 프로필, 개별 동영상 메타데이터, 최상위 댓글, 동영상 검색 결과, 지정한 해시태그의 동영상을 하나의 정규화된 비동기 워크플로로 수집합니다.

사용할 수 있는 TikTok API

프로필 조회, 개별 동영상 정보 보강, 최상위 댓글, 키워드 동영상 검색, 지정한 해시태그의 동영상 수집 중에서 고르세요.

tiktok/profiles

프로필결과당 0.6 크레딧

tiktok/videos

게시물결과당 0.7 크레딧

tiktok/video-transcript

게시물결과당 0.5 크레딧

tiktok/comments

댓글결과당 0.25 크레딧

tiktok/comment-replies

댓글결과당 0.5 크레딧

tiktok/search

검색결과당 0.7 크레딧

tiktok/hashtags

검색결과당 0.7 크레딧

tiktok/trending-feed

게시물결과당 0.7 크레딧

tiktok/followers-list

프로필결과당 0.5 크레딧

tiktok/following-list

프로필결과당 0.5 크레딧

tiktok/user-videos

게시물결과당 0.5 크레딧

tiktok/live-room-info

검색결과당 0.5 크레딧

tiktok/search-users

검색결과당 0.6 크레딧

tiktok/song

게시물결과당 0.5 크레딧

tiktok/song-videos

게시물결과당 0.5 크레딧

tiktok/popular-songs

게시물결과당 0.5 크레딧

tiktok/top-search

검색결과당 0.7 크레딧

tiktok/user-live

게시물결과당 0.5 크레딧

tiktok/user-audience

프로필요청당 20 크레딧

tiktok/similar-users

프로필결과당 0.5 크레딧

tiktok/user-reposts

게시물결과당 0.5 크레딧

tiktok/user-playlists

게시물결과당 0.5 크레딧

tiktok/hashtag-detail

검색결과당 0.5 크레딧

tiktok/search-music

검색결과당 0.6 크레딧

tiktok/search-live

검색결과당 0.6 크레딧

tiktok/search-photos

검색결과당 0.6 크레딧

tiktok/trending-keywords

검색요청당 0.5 크레딧

tiktok/search-insights

검색요청당 1 크레딧

tiktok/live-ranking

프로필요청당 0.5 크레딧

tiktok/live-products

상품결과당 0.1 크레딧

tiktok/fake-views

게시물요청당 5 크레딧

tiktok/comment-keywords

댓글요청당 1 크레딧

어떤 TikTok 데이터를 가져올 수 있나요?

SocQ는 지원하는 공개 TikTok 결과를 정규화된 레코드로 변환해 크리에이터 리서치, 콘텐츠 분석, 모니터링, 데이터 파이프라인에 활용할 수 있게 합니다.

공개 프로필

사용자 이름으로 식별 정보, 소개, 계정 플래그, 공개된 팔로워·팔로잉·동영상·좋아요 수를 가져옵니다.

공개 동영상

캡션, 크리에이터 정보, 참여도 스냅샷, 미디어 참조, 길이, 해시태그, 멘션, 사운드, 콘텐츠 플래그를 수집합니다.

최상위 댓글

공개 최상위 댓글 텍스트, 작성자 정보, 좋아요 수, 답글 수, 멘션, 크리에이터 상호작용 플래그를 수집합니다.

동영상 탐색

지원하는 필터로 공개 동영상을 검색하거나 지정한 해시태그의 공개 동영상을 수집합니다.

SocQ와 TikTok 개발자 제품

SocQ는 지원하는 공개 데이터 수집과 정규화된 레코드에 집중합니다. 애플리케이션에 플랫폼 권한이나 공식 계정·콘텐츠 기능이 필요하다면 TikTok의 공식 개발자 제품을 사용하세요.

기능SocQTikTok 개발자 제품
주요 용도지원하는 공개 데이터 수집과 정규화해당 TikTok 제품과 승인에 따른 공식 연동
인증SocQ API 키TikTok 개발자 자격 증명과 해당 권한
콘텐츠 작업TikTok 콘텐츠를 업로드·수정·삭제·좋아요·팔로우·메시지 전송·관리하지 않음승인된 공식 제품과 권한에 따라 다름
비공개·제한 데이터지원하지 않음공식 제품, 권한, 플랫폼 정책 범위 내로 제한
응답 형식정규화된 SocQ 레코드제품별 고유 응답

TikTok API 작동 방식

모든 엔드포인트가 비동기 제출, 폴링, 커서 페이지네이션 흐름을 공유합니다.

  1. 1. 공개 입력 제출

    사용자 이름, 개별 동영상 URL, 검색어, 지정한 해시태그를 엔드포인트별 옵션과 함께 POST합니다.

  2. 2. 작업 폴링

    반환된 task_id로 처리가 성공하거나 실패할 때까지 /v1/tasks/{task_id}를 폴링합니다.

  3. 3. 읽기와 페이지네이션

    data.results.items에서 정규화된 레코드를 읽고, has_more가 true인 동안 next_cursor를 따라갑니다.

API 요청 한 번으로 시작

SocQ API 키로 인증합니다. 이 예시는 공개 프로필을 가져옵니다. 개별 동영상, 최상위 댓글, 검색, 해시태그는 다른 엔드포인트를 선택하세요.

curl -X POST "https://api.socq.ai/v1/tiktok/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

TikTok API 주요 활용 사례

크리에이터 리서치

알고 있는 사용자 이름의 공개 프로필 식별 정보와 수집 시점의 계정 수치를 정규화합니다.

콘텐츠·반응 모니터링

선택한 동영상 메타데이터와 공개 최상위 댓글 스냅샷을 수집해 검토와 리포팅에 활용합니다.

주제 탐색

키워드로 공개 동영상을 검색하거나 지정한 해시태그와 연결된 동영상을 수집합니다.

데이터 파이프라인

정규화된 레코드를 데이터 웨어하우스, 분류기, 검색 색인, 검토 도구, 대시보드로 전달합니다.

제한 사항과 공개 데이터 정책

TikTok 공개 결과는 수시로 바뀌며, 현재 노출 상태, 원본의 대상 요건, 정렬, 지역, 제공 가능 여부에 따라 달라집니다.

  • 비공개, 삭제됨, 제한됨, 필터링됨 등 접근할 수 없는 리소스는 레코드가 생성되지 않을 수 있습니다.
  • 공개된 카운터, 검색 순위, 댓글 정렬, 공개 여부는 수집 이후에 바뀔 수 있습니다.
  • 요청한 results_limit은 상한일 뿐이며, 그만큼의 공개 레코드가 존재한다는 보장은 아닙니다.
  • SocQ는 TikTok 공식 API가 아니며 계정 권한 부여, 콘텐츠 관리, 좋아요, 팔로우, 업로드, 다이렉트 메시지를 수행하지 않습니다.

TikTok API 자주 묻는 질문

SocQ는 TikTok 공식 API인가요?

아니요. SocQ는 지원하는 공개 결과를 수집하고 정규화합니다. 공식 권한 부여와 승인된 플랫폼 작업에는 TikTok의 개발자 제품을 사용하세요.

사용자가 TikTok 계정을 연결해야 하나요?

이 공개 데이터 엔드포인트에는 고객의 TikTok OAuth가 필요하지 않습니다. 요청은 SocQ API 키로 인증합니다.

어떤 TikTok 리소스를 사용할 수 있나요?

Profiles, Videos, Comments, Search, Hashtags를 사용할 수 있으며, 각각 문서화된 입력과 정규화된 결과 사양을 갖추고 있습니다.

요금은 어떻게 부과되나요?

Profiles는 결과 1건당 0.6 크레딧, Videos·Search·Hashtags는 0.7 크레딧, Comments는 0.25 크레딧입니다.

여러 플랫폼의 공개 프로필, 콘텐츠, 참여도 데이터를 하나의 워크플로로 모으면 브랜드, 크리에이터, 주제를 추적하고 플랫폼 간 모니터링과 분석을 더 효율적으로 진행할 수 있습니다.