tiktok-creative-center/
top-videos

TikTok Creative Center의 국가별 인기 영상 차트를 조회수, 참여율, 6초 조회율 기준으로 받고, 오가닉 조회수와 크리에이터 Marketplace ID를 함께 제공합니다.

TikTok Creative Center Top Videos API

국가별 차트
일간·주간·장기
조회수와 참여율
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

TikTok Creative Center Top Videos

Creative Center의 인기 영상은 한 국가에서 성과가 가장 좋은 동영상을 TikTok이 공개한 차트로, 조회수, 참여율, 6초 조회율 기준으로 순위를 매기고 영상마다 캡션, 크리에이터, 차트 기간의 조회수, 누적 조회수, 오가닉 조회수를 보여 줍니다. 이 차트를 보면 시장에서 어떤 영상이 관심을 얻는지, 도달 중 오가닉 비중이 얼마인지, 어떤 크리에이터가 계속 이름을 올리는지 알 수 있습니다.

TikTok Creative Center Top Videos API 주요 기능

  • 일간·주간·장기 차트period로 국가의 어느 차트를 읽을지 고르며, 가장 최근에 공개된 회차가 자동으로 사용됩니다.
  • 순위 기준 세 가지sort_by가 차트를 views, engagement_rate, six_second_view_rate 기준으로 정렬합니다.
  • 도달을 세 갈래로 구분metrics가 차트 기간의 views_count, organic_views_count, lifetime_views_count를 구분해 두 가지 비율과 함께 제공합니다.
  • 영상과 크리에이터 식별 정보행마다 캡션, url, cover_url, author가 있고, TikTok Creator Marketplace가 받는 Creator Marketplace ID인 creator_id도 들어 있습니다.

TikTok Creative Center Top Videos API 매개변수

매개변수필수설명
country선택시장의 두 글자 국가 코드이며, US, GB, JP 등이 있습니다. 기본값은 US입니다.
period선택읽을 차트로, daily(기본값), weekly, long_term 중 하나입니다.
sort_by선택순위 기준 지표로, views(기본값), engagement_rate, six_second_view_rate 중 하나입니다.
results_limit선택반환할 동영상의 개수로, 1~100 사이 값입니다. 기본값은 20입니다.

TikTok Creative Center Top Videos API 사용 방법

국가, 기간, 기준 지표를 고르고 차트를 읽습니다.

  1. {"country": "US", "period": "daily", "results_limit": 20}을 /v1/tiktok-creative-center/top-videos로 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/tiktok-creative-center/top-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"daily","sort_by":"views","results_limit":20}'

# creator_id on each item feeds TikTok Creator Marketplace.

TikTok Creative Center Top Videos API 추천 활용 사례

  • 후킹 벤치마킹: 국가별 차트를 six_second_view_rate로 정렬하고 상위 영상의 캡션과 커버를 살펴, 6초 넘게 시청자를 붙잡는 오프닝을 정리합니다.
  • 오가닉 도달과 유료 도달 구분: 행마다 organic_views_count를 views_count로 나누면, 자연스럽게 커진 영상과 유료 확산에 크게 기댄 영상을 가를 수 있습니다.
  • 주간 시장 스냅샷: 국가별 주간 차트를 매주 저장하고 id로 행을 비교하면, 어떤 영상과 크리에이터가 반복해 오르고 어떤 형식이 빠지는지 알 수 있습니다.
  • 크리에이터 후보 목록: 차트 행의 creator_id를 모아 중복을 제거한 뒤 Creator Marketplace로 보내면 오디언스와 단가 정보를 받을 수 있습니다.

TikTok Creative Center Top Videos API 활용 팁

  • engagement_rate와 six_second_view_rate는 비율로 읽으세요. 0.0265는 2.65가 아니라 2.65퍼센트입니다.
  • rank는 선택한 sort_by 기준의 순위이므로, country, period, sort_by가 같은 실행끼리만 순위를 비교하세요.
  • 크리에이터 한 명이 여러 행을 차지할 수 있으니 중복된 creator_id를 합친 뒤 넘기세요. Creator Marketplace는 요청 한 번에 ID를 최대 20개까지 받습니다.

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

다른 플랫폼 둘러보기

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

TikTok Creative Center Top Videos API — 자주 묻는 질문

TikTok Creative Center Top Videos API는 TikTok Creative Center의 성과 좋은 동영상 차트를 국가, 기간, 순위 지표별로 가져오는 프로그래밍 인터페이스입니다. 영상별 순위, 캡션, 크리에이터, 차트 기간·오가닉·누적 조회수, 참여율, 6초 조회율을 반환합니다.

views는 차트 기간의 도달 규모로 정렬합니다. engagement_rate는 참여 수를 조회수로 나눈 값으로 정렬해 반응을 끌어내는 영상이 유리하고, six_second_view_rate는 조회 중 6초 이상 시청된 비율로 정렬해 오프닝이 강한 영상을 가리킵니다.

가장 최근에 공개된 회차이며, 보통 현재 날짜보다 2일쯤 늦습니다. 주간 차트는 일요일에 끝납니다.

두 종류의 도달이 모두 집계됩니다. views_count는 차트 기간의 모든 조회수이고 organic_views_count는 유료가 아닌 확산으로 얻은 부분이므로, 후자가 전자보다 훨씬 작은 행은 대부분 유료로 확산된 영상입니다.

author.id는 크리에이터의 TikTok 사용자 ID이고, creator_id는 TikTok Creator Marketplace가 받는 값인 Creator Marketplace ID입니다.

views_count는 차트 기간의 조회수만 집계하므로, 몇 달 전에 올라온 영상도 지금 사람들이 계속 보고 있으면 순위에 오를 수 있습니다. 게시 이후 전체 조회수는 lifetime_views_count에서 확인하세요.

모든 시장에 모든 기간의 차트가 있는 것은 아닙니다. 이때 작업은 성공 처리되어 결과가 0건이고 청구되지 않으므로, 다른 기간이나 국가를 비용 없이 시도할 수 있습니다. 차트가 있으면 행 1개당 0.5 크레딧입니다.