TikTok Creative Center Top Ads
TikTok Creative Center의 Top Ads는 TikTok에서 성과가 좋은 광고를 골라 모아 둔 목록으로, 광고마다 캡션, 업종, 캠페인 목표, 클릭률, 좋아요 수, 영상이 함께 표시됩니다. 여러 광고를 훑어보면 한 카테고리에서 어떤 후킹, 형식, 혜택이 계속 통하는지 드러나므로 크리에이티브 조사, 경쟁사 모니터링, 광고 기획서 작성에 쓰기 좋습니다.
TikTok Creative Center Top Ads API 주요 기능
- Creative Center의 Top Ads 목록 그대로Creative Center가 성과 상위로 올린 광고가 결과로 오며, 정렬은 TikTok의 관련도순 또는 좋아요순입니다.
- 광고마다 CTR, 좋아요, 캠페인 맥락광고마다 ctr과 likes가 있고, Creative Center가 붙인 업종과 광고 목표도 함께 들어 있습니다.
- 수치만이 아니라 영상까지media가 썸네일, 가로·세로 크기, 길이와 함께 광고 영상 URL을 돌려주고, text에는 캡션이 들어 있습니다.
- 키워드, 기간, 개수 조절query로 키워드를 좁히고, time_range로 7·30·180일 전까지 거슬러 올라가며, results_limit으로 요청 한 번에 최대 300개 광고를 받습니다.
TikTok Creative Center Top Ads API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
query | 선택 | 광고를 걸러 낼 선택 키워드이며, 상품 카테고리 등을 넣을 수 있습니다. |
time_range | 선택 | 거슬러 올라갈 기간으로, 7d, 30d(기본값), 180d 중 하나입니다. |
sort_by | 선택 | relevance는 TikTok의 기본 순서(기본값), likes는 좋아요가 많은 광고부터입니다. |
results_limit | 선택 | 반환할 광고의 개수로, 1~300 사이 값입니다. 기본값은 20입니다. |
TikTok Creative Center Top Ads API 사용 방법
인기 광고를 필터링하고 결과를 페이지 단위로 읽습니다.
- {"query": "skincare", "time_range": "30d", "sort_by": "likes"}를 /v1/tiktok-creative-center/top-ads로 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-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'
# Each item's id can be sent to TikTok Creative Center Ad Analysis.TikTok Creative Center Top Ads API 추천 활용 사례
- 상품 카테고리별 레퍼런스 모음 만들기: 상품 키워드로 조회해 상위 광고의 캡션, 영상, duration_seconds를 디자이너와 편집자를 위한 레퍼런스 세트로 보관합니다.
- 반짝 후킹과 오래 가는 후킹 구분: 같은 키워드를 7d와 180d로 각각 실행해, 두 기간에 모두 있는 광고는 계속 통하는 형식이고 짧은 기간에만 있는 광고는 지금 시도되는 실험으로 봅니다.
- 광고 목표별로 CTR 상위 추리기: 많은 수를 한 번에 가져와 목표별로 묶고, 그룹마다 ctr로 순위를 매겨 자세히 볼 만한 광고를 가려냅니다.
- 후킹과 형식을 대규모로 라벨링: 캡션, 영상 파일, 길이를 자체 태깅 파이프라인에 넣어, 한 카테고리에서 어떤 후킹 유형과 길이가 우세한지 집계합니다.
TikTok Creative Center Top Ads API 활용 팁
- ctr은 같은 결과 세트, 같은 광고 목표의 광고끼리만 비교하세요. 단위가 문서화되어 있지 않고 결과에 예산이나 혜택 정보도 없으므로, 일반적인 TikTok CTR 기준이 아니라 광고끼리 순위를 매기세요.
- sort_by는 relevance와 likes만 지원하므로, results_limit을 크게 잡아 받은 뒤 코드에서 ctr로 직접 정렬하세요.
- 필드는 방어적으로 읽으세요. industry와 objective는 campaign_objective_video_view 같은 Creative Center 라벨 코드로 오고, 문서의 샘플에서는 advertiser와 metrics의 댓글·공유·조회 수가 null입니다.
- 실행할 때마다 광고의 id를 저장하고 이를 기준으로 중복을 제거하세요. 같은 광고가 다른 검색어와 기간에서 다시 나올 수 있습니다.
- 추려 낸 id만 TikTok Creative Center Ad Analysis로 보내세요. 광고당 1 크레딧이 들고, 노출 국가와 초 단위 곡선이 추가됩니다.
관련 API
TikTok Creative Center Top Ads API 외에 TikTok Creative Center의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.
- TikTok Creative Center Ad Analysis API — 상위 광고 하나를 클릭률·유지율 곡선으로 초 단위까지 분석합니다.
- TikTok Creative Center Trending Hashtags API — 국가별 트렌드 해시태그 순위를 게시물 수, 조회수, 인기 곡선과 함께 가져옵니다.
- TikTok Creative Center Hashtag Insights API — 트렌드 해시태그 하나의 인기 곡선, 상위 국가, 예시 동영상을 자세히 살펴봅니다.
- TikTok Creative Center Top Videos API — 국가별 성과 상위 동영상 차트를 조회수, 참여율과 함께 가져옵니다.
- TikTok Creator Marketplace API — Creator Marketplace 카드를 팔로워 인구통계, 조회수 중앙값, 시작 단가와 함께 가져옵니다.