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 사용 방법
국가, 기간, 기준 지표를 고르고 차트를 읽습니다.
- {"country": "US", "period": "daily", "results_limit": 20}을 /v1/tiktok-creative-center/top-videos로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링합니다.
- 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개까지 받습니다.
관련 API
TikTok Creative Center Top Videos API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Creative Center Top Ads API — 키워드와 기간으로 성과 상위 광고를 탐색하며, 캡션, CTR, 좋아요 수, 광고 동영상을 포함합니다.
- TikTok Creative Center Ad Analysis API — 상위 광고 하나를 클릭률·유지율 곡선으로 초 단위까지 분석합니다.
- TikTok Creative Center Trending Hashtags API — 국가별 트렌드 해시태그 순위를 게시물 수, 조회수, 인기 곡선과 함께 가져옵니다.
- TikTok Creative Center Hashtag Insights API — 트렌드 해시태그 하나의 인기 곡선, 상위 국가, 예시 동영상을 자세히 살펴봅니다.
- TikTok Creator Marketplace API — Creator Marketplace 카드를 팔로워 인구통계, 조회수 중앙값, 시작 단가와 함께 가져옵니다.