tiktok-creative-center/
top-ads

키워드, 7·30·180일 기간, 정렬 기준으로 TikTok Creative Center의 성과 좋은 광고를 가져와 캡션, CTR, 좋아요 수, 광고 목표, 업종, 광고 영상을 받습니다.

TikTok Creative Center Top Ads API

성과 좋은 광고
광고별 CTR
광고 영상 파일
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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 사용 방법

인기 광고를 필터링하고 결과를 페이지 단위로 읽습니다.

  1. {"query": "skincare", "time_range": "30d", "sort_by": "likes"}를 /v1/tiktok-creative-center/top-ads로 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-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 크레딧이 들고, 노출 국가와 초 단위 곡선이 추가됩니다.

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

다른 플랫폼 둘러보기

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

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

TikTok Creative Center Top Ads API는 TikTok Creative Center에 올라온 성과 좋은 광고를 키워드, 기간, 정렬 기준으로 걸러 수집하는 프로그래밍 인터페이스입니다. 광고별 캡션, 업종, 목표, 클릭률, 좋아요 수, 영상을 반환합니다.

아니요. Top Ads는 성과가 좋은 광고를 골라 CTR과 좋아요 수와 함께 보여 주는 목록이고, TikTok Ad Library는 집행된 광고를 광고주나 키워드로 검색하는 투명성 아카이브이며 CTR은 제공하지 않습니다.

아니요. Top Ads에는 광고주가 Creative Center 노출을 승인한 광고만 올라오므로, 성과 상위 광고의 일부일 뿐 전체 기록이 아닙니다. 광고주 단위 조회에는 TikTok Ad Library 엔드포인트를 사용하세요.

이 엔드포인트로는 안 됩니다. 키워드와 time_range로만 필터링합니다. 업종과 광고 목표는 광고마다 들어 있으니 요청 후에 직접 걸러 내고, 광고의 노출 국가는 TikTok Creative Center Ad Analysis에서 확인하세요.

sort_by는 relevance와 likes만 받습니다. 광고를 최대 300개까지 요청한 뒤 반환된 ctr로 직접 정렬하세요.

반환된 광고 1개당 0.5 크레딧이므로 300개면 150 크레딧입니다. 광고가 하나도 반환되지 않은 요청은 청구되지 않습니다.

광고마다 media 항목에 영상 URL, 썸네일, 크기, 길이가 있어 파일을 가져올 수 있습니다. 영상의 권리는 광고주에게 있으므로 재게시가 아니라 조사와 참고 용도로 사용하세요.