API 목록으로 돌아가기
TikTok Creative Center 리서치 데이터

TikTok Creative Center API

TikTok Creative Center의 순위를 조회할 수 있는 데이터로 바꿉니다. 성과 상위 광고, 국가별 인기 해시태그, 인기 동영상 차트, Creator Marketplace 카드를 가져옵니다.

사용할 수 있는 TikTok Creative Center API

Top Ads, Trending Hashtags, Top Videos는 순위를 읽고, Ad Analysis, Hashtag Insights, Creator Marketplace는 그 순위에서 고른 광고 하나, 해시태그 하나, 크리에이터 여러 명을 더 깊이 분석합니다.

Creative Center에서 어떤 데이터를 가져올 수 있나요?

각 엔드포인트는 선택한 광고, 해시태그, 차트, 크리에이터에 대해 Creative Center가 보여 주는 내용을 바탕으로 일정한 형식의 SocQ 레코드를 반환합니다.

성과 상위 광고

Creative Center가 선정한 광고의 캡션, 업종, 광고 목표, 클릭률 점수, 좋아요 수, 영상 미디어를 제공하고, 광고 하나에 대해서는 타깃 국가, 노출 백분위, 초 단위 클릭률 곡선과 시청 유지율 곡선까지 제공합니다.

트렌딩 해시태그

7일, 30일, 90일 기준 국가별 순위에 순위, 게시물 수, 조회수, 일별 인기도 곡선이 붙고, Hashtag Insights는 태그 하나에 대해 점수 기준 상위 국가와 예시 영상 ID를 더합니다.

인기 동영상 차트

국가별 일간·주간·장기 차트에 캡션, 크리에이터, 기간 내 조회수, 오가닉·누적 조회수, 참여율, 6초 조회율, 크리에이터의 Marketplace ID가 들어 있습니다.

Creator Marketplace 카드

팔로워의 연령, 성별, 국가, 기기 비중과 중앙값 조회수, 참여율과 팔로워 성장률, 크리에이터가 협찬 영상에 공개한 시작 단가를 제공합니다.

SocQ와 TikTok Creative Center

Creative Center는 웹 화면에서 순위를 둘러보는 TikTok의 리서치 사이트입니다. SocQ는 같은 순위를 저장하고 비교하고 결합할 수 있는 API 레코드로 반환합니다.

기능SocQTikTok Creative Center
접근 방식API 키와 JSON 레코드웹 화면
대량 수집작업 1건당 광고 최대 300개, 해시태그 최대 100개, 동영상 최대 100개페이지 단위로 탐색
후속 분석한 순위에서 얻은 ID를 다음 엔드포인트에 그대로 입력페이지 사이를 직접 이동
출력설명이 붙은 일정한 SocQ 필드시각적인 차트와 카드

TikTok Creative Center API 작동 방식

6개 엔드포인트 모두 같은 비동기 흐름, 즉 제출, 폴링, 읽기 순서를 따릅니다.

  1. 1. 순위 읽기

    Top Ads, Trending Hashtags, Top Videos에 키워드, 국가, 기간 같은 필터를 제출합니다.

  2. 2. 작업 폴링

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

  3. 3. 더 깊이 들어가기

    광고 id는 Ad Analysis로, 해시태그 id는 Hashtag Insights로, creator_id 값은 Creator Marketplace로 보냅니다.

API 요청 한 번으로 시작

SocQ API 키로 인증합니다. Top Ads의 기본 결과 수는 20건이며 최대 300건까지 받을 수 있습니다.

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"}'

# Then analyze one ad:
# POST /v1/tiktok-creative-center/ad-analysis
# {"ad_id":"7697084527089729557"}
# Poll GET /v1/tasks/{task_id}

TikTok Creative Center API 주요 활용 사례

경쟁사 광고 탐색

Top Ads를 키워드로 검색하고 좋아요순으로 정렬한 뒤, 광고마다 업종, 광고 목표, 클릭률 점수를 읽어 그 카테고리에서 어떤 크리에이티브 접근이 반응을 얻는지 파악합니다.

광고 이탈 구간 진단

Top Ads의 id를 Ad Analysis로 보내 click_through_curve와 retention_curve를 초 단위로 겹쳐 보면, 시청자가 어디서 클릭하고 어디서 떠나는지 알 수 있습니다.

시장별 해시태그 추적

목표 국가별 트렌딩 해시태그를 일정 주기로 가져오고, 게시물을 기획하기 전에 popularity_curve로 아직 오르는 태그를 가려냅니다.

후킹과 도달 벤치마킹

국가별 영상 차트를 six_second_view_rate로 정렬하고 organic_views_count를 views_count와 견주어, 어떤 오프닝이 시청자를 붙잡는지, 어떤 영상이 주로 유료 확산인지 가려냅니다.

크리에이터 후보 선별

영상 차트에서 creator_id 값을 가져와, Creator Marketplace 카드에서 오디언스 비중, 중앙값 조회수, 참여율, 공개된 시작 단가를 비교합니다.

데이터 범위

결과는 순위, 시장, 기간마다 Creative Center가 공개하는 내용을 따릅니다.

  • Top Ads에는 Creative Center의 성과 기준을 충족하고 광고주가 노출을 승인한 광고만 올라오므로, TikTok의 모든 광고가 아니라 골라 둔 일부입니다.
  • 영상 차트는 시차를 두고 공개됩니다. 일간 차트는 약 2일 늦고 주간 차트는 일요일에 끝나는 주 단위이며, 차트가 없는 시장은 결과가 0건이고 청구되지 않습니다.
  • Creator Marketplace 카드는 TikTok Creator Marketplace에 가입한 크리에이터에게만 있고 Marketplace ID로 조회하므로, 다른 곳에서 가져온 ID는 일치하지 않습니다.
  • 해시태그 순위는 국가와 기간만 받고 업종 필터는 없으며, 순위 행의 상위 국가와 예시 영상은 Hashtag Insights에서 확인합니다.
  • 클릭률 점수, 백분위, 인기도 값은 Creative Center가 보고하는 상대 지표이며 계정 단위의 캠페인 리포트가 아닙니다.

TikTok Creative Center API 자주 묻는 질문

TikTok Creative Center API란 무엇인가요?

TikTok Creative Center API는 TikTok Creative Center의 인기 광고, 트렌딩 해시태그, 인기 동영상 차트, Creator Marketplace 카드를 정규화된 JSON 레코드로 읽는 프로그래밍 인터페이스입니다.

TikTok 계정이나 광고 계정이 필요한가요?

아니요. 요청에는 SocQ API 키를 사용하며, Creative Center가 공개 리서치 페이지에서 보여 주는 순위를 읽어 옵니다.

순위에서 광고, 해시태그, 크리에이터 하나로 넘어가려면 어떻게 하나요?

각 순위가 상세 엔드포인트가 받는 ID를 돌려줍니다. 광고 id는 Ad Analysis로, 해시태그 id는 같은 국가와 함께 Hashtag Insights로, Top Videos의 creator_id는 Creator Marketplace로 보냅니다.

Top Ads와 Top Videos는 무엇이 다른가요?

Top Ads는 유료 TikTok 광고를 클릭률 점수, 업종, 광고 목표와 함께 돌려줍니다. Top Videos는 국가별 영상 차트를 조회수, 오가닉 조회수, 참여율, 크리에이터의 Marketplace ID와 함께 돌려줍니다.

데이터는 얼마나 최신인가요?

요청 시점에 Creative Center가 공개한 내용을 돌려주며 모든 레코드에 collected_at 타임스탬프가 있습니다. 일간 영상 차트는 현재 날짜보다 약 2일 늦고 주간 차트는 일요일에 끝납니다.

엔드포인트별 요금은 어떻게 되나요?

Top Ads, Trending Hashtags, Top Videos, Creator Marketplace는 반환된 결과 1건당 0.5 크레딧입니다. Ad Analysis는 요청 1건당 1 크레딧, Hashtag Insights는 요청 1건당 0.5 크레딧입니다.

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