TikTok Creative CenterTikTok 광고트렌드 해시태그Creator MarketplaceAPI 가이드

TikTok Creative Center API: 인기 광고, 트렌드 해시태그, 크리에이터 단가

SocQ 신규 엔드포인트 6개로 TikTok Creative Center를 읽습니다. 초 단위 시청 유지 곡선이 담긴 인기 광고, 국가별 트렌드 해시태그, 인기 동영상 차트, Creator Marketplace 카드를 가져옵니다.

SocQ2026년 11월 19일 업데이트약 7분 소요

TikTok Creative Center는 마케터가 성과가 가장 좋은 광고, 특정 국가에서 상승 중인 해시태그, 차트 상위권 동영상을 찾아보는 곳입니다. Creator Marketplace는 여기에 크리에이터의 오디언스 데이터와 시작 단가를 더합니다. 2026-11-17 SocQ는 이 데이터를 JSON으로 반환하는 엔드포인트 6개를 추가했으며, TikTok Creative Center 플랫폼 페이지에서 확인할 수 있습니다.

6개 엔드포인트는 두 개씩 세 쌍으로 동작합니다. 목록 엔드포인트로 후보를 찾고, 상세 엔드포인트에 그 목록의 ID를 넘겨 깊이 있는 데이터를 받습니다. 이 가이드에서는 쌍마다 반환 내용, 요청, 가격, 활용 시점을 다룹니다.

빠른 답변: POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>에 JSON 본문을 보내세요. 반환된 task_id를 저장하고 status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 data.results.items를 읽습니다.

신규 TikTok Creative Center 엔드포인트

1 SocQ 크레딧 = $0.005입니다. 목록 엔드포인트는 기본 요금 없이 결과 단위로 과금됩니다.

엔드포인트반환 내용가격
Top Ads API성과 상위 광고와 캡션, 광고주, 업종, 목표, CTR, 좋아요, 동영상광고 1개당 0.5 크레딧($0.0025)
Ad Analysis API광고 1개의 상세 정보, 노출 백분위, 초 단위 클릭률·시청 유지 곡선호출 1회당 1 크레딧($0.005)
Trending Hashtags API국가별 트렌드 해시태그와 순위, 게시물 수, 조회수, 일별 인기도 곡선해시태그 1개당 0.5 크레딧($0.0025)
Hashtag Insights API해시태그 1개의 합계, 인기도 곡선, 상위 국가, 예시 동영상 ID호출 1회당 0.5 크레딧($0.0025)
Top Videos API국가별 인기 동영상 차트와 순위, 크리에이터, 차트 기간·누적 조회수, 참여율동영상 1개당 0.5 크레딧($0.0025)
Creator Marketplace API팔로워 연령·성별·국가·기기 구성, 조회수 중앙값, 참여율, 시작 단가가 담긴 크리에이터 카드크리에이터 1명당 0.5 크레딧($0.0025)

인증과 비동기 작업 흐름

모든 요청은 API 키로 인증합니다. 제출, 작업 상태 조회, 결과 조회 요청에 같은 헤더를 사용합니다.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

모든 수집은 백그라운드 작업으로 실행됩니다.

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

제출 호출은 즉시 data.task_id와 data.status를 반환합니다. 이 ID로 작업을 폴링하세요.

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

status가 succeeded가 되면 응답에 result_count, credits_amount, 그리고 data.results.items에 담긴 정규화 레코드의 첫 페이지가 포함됩니다. limit의 기본값은 50이고 최대 500입니다. results.has_more가 true이면 results.next_cursor를 cursor로 전달해 다음 페이지를 읽으세요. 실패한 작업에는 error_message가 담깁니다.

여기서 소개하는 모든 엔드포인트는 선택 사항인 callback_url도 받습니다. 작업이 끝나면 SocQ가 작업 요약을 담은 POST를 한 번 보내며, 레코드는 작업 엔드포인트에서 읽습니다. 클라이언트 측 타임아웃이 작업을 취소하지는 않으므로 다시 제출하지 말고 같은 작업 ID로 조회를 이어가세요. 402는 계정의 크레딧이 부족하다는 뜻이고, 429는 키가 속도 또는 크레딧 한도에 도달했다는 뜻입니다.

Top Ads와 Ad Analysis: 광고 레퍼런스 모음 만들기

Top Ads API는 TikTok Creative Center가 성과 상위로 꼽은 광고를 탐색합니다. 각 광고에는 캡션, 광고주, 업종, 캠페인 목표, ctr, 좋아요, 전체 동영상이 담깁니다. 모든 필드는 선택 사항입니다. query는 광고 캡션과 브랜드를 대상으로 검색하고, time_range는 7d, 30d(기본값), 180d 중 하나이며, sort_by는 relevance(기본값) 또는 likes입니다. results_limit은 기본값 20이고 1부터 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"}'

Ad Analysis API는 Top Ads 결과 하나의 id를 ad_id로 받습니다. 광고의 상세 정보, 국가, 랜딩 페이지와 함께 비슷한 광고 대비 impressions_percentile, 그리고 동영상의 초마다 값이 하나씩 담긴 click_through_curve와 retention_curve를 반환합니다. 두 곡선을 함께 읽으면 훅이 걸리는 지점, 시청자가 이탈하는 지점, 행동하는 순간을 찾을 수 있습니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ad_id": "7697084527089729557"}'

활용 시점: 새 캠페인을 위한 크리에이티브 리서치. 카테고리 내 인기 광고 20개를 가져오고(10 크레딧) 가장 관련성 높은 5개를 분석합니다(5 크레딧). 합계 15 크레딧, 즉 $0.075입니다.

Trending Hashtags API는 한 국가에서 상승 중인 해시태그를 반환하며, 각 해시태그의 순위, 게시물 수, 조회수, 해당 기간의 일별 popularity_curve를 담습니다. 모든 필드는 선택 사항입니다. country는 두 글자 코드(기본값 US)이고, time_range는 7d(기본값), 30d, 90d 중 하나입니다. results_limit은 기본값 20이고 1부터 100까지 받습니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country": "US", "time_range": "7d", "results_limit": 20}'

Hashtag Insights API는 Trending Hashtags의 id를 hashtag_id로, 같은 country와 함께 받습니다. 게시물·조회수 합계, 일별 인기도 곡선, 각 국가의 규모 대비 태그 인기도 점수가 담긴 top_countries, 예시 동영상의 video_ids를 반환합니다. time_range의 기본값은 7d입니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'

활용 시점: 특정 시장의 출시 캠페인에 쓸 해시태그를 고르거나, 태그를 중심으로 콘텐츠를 만들기 전에 그 태그가 글로벌한지 로컬한지 확인할 때. 트렌드에 오르지 않은 태그를 포함해 이미 염두에 둔 해시태그의 규모를 알고 싶다면, TikTok Hashtag Views API가 최대 20개 태그의 전체 동영상 수와 조회수를 한 번에 반환합니다.

Top Videos와 Creator Marketplace: 크리에이터와 단가 찾기

Top Videos API는 TikTok Creative Center의 국가별 성과 상위 동영상 차트를 읽습니다. 각 항목에는 순위, 캡션, 크리에이터, creator_id, 차트 기간 조회수, 오가닉 조회수, 누적 조회수, 참여율, 6초 시청률이 담깁니다. 모든 필드는 선택 사항입니다. country의 기본값은 US이고, period는 daily(기본값), weekly, long_term 중 하나이며, sort_by는 views(기본값), engagement_rate, six_second_view_rate 중 하나입니다. 가장 최근에 게시된 차트를 사용합니다. results_limit은 기본값 20이고 1부터 100까지 받습니다. (문서)

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", "results_limit": 20}'

Creator Marketplace API는 Top Videos의 creator_id 값 같은 숫자형 creator_ids를 1개부터 20개까지 받습니다. 카드가 있는 각 크리에이터에 대해 팔로워의 연령, 성별, 국가, 기기 구성, 팔로워 수, 조회수 중앙값, 참여율, 팔로워 증가율, 6초 시청률, 최근 동영상 ID, 그리고 스폰서 동영상에 대해 제시한 starting_price를 반환합니다. 카드가 있는 크리에이터만 과금됩니다. (문서)

curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'

활용 시점: 예산을 고려해 크리에이터 후보 목록을 만들 때. 동영상 20개짜리 일간 차트(10 크레딧)와 크리에이터 20명의 카드(10 크레딧)를 합쳐 20 크레딧, 즉 $0.10입니다.

다른 TikTok 엔드포인트와의 관계

Creative Center 데이터는 차트, 순위, 곡선처럼 TikTok이 집계한 데이터입니다. 크리에이터 본인의 프로필, 동영상, 댓글은 TikTok 스크래핑 가이드의 엔드포인트를 사용하세요. 크리에이터 공개 계정 기반의 팔로워 국가와 가짜 조회수 확인은 TikTok 신규 엔드포인트 가이드를 참고하세요. Meta에서 집행되는 광고는 Facebook Ad Library API에서 다룹니다.

자주 묻는 질문(FAQ)

TikTok Ads나 Creator Marketplace 계정이 필요한가요?

아니요. SocQ API 키로 인증하고 위에 나온 필드를 보내면 됩니다.

ad_id는 어디서 얻나요?

Top Ads 결과에서 얻습니다. 결과의 id를 Ad Analysis에 ad_id로 전달하세요. 같은 방식으로 Trending Hashtags의 id는 Hashtag Insights에 hashtag_id로, Top Videos의 creator_id는 Creator Marketplace에 전달합니다.

어떤 국가를 조회할 수 있나요?

Trending Hashtags, Hashtag Insights, Top Videos는 US, GB, JP 같은 두 글자 country 코드를 받으며 기본값은 US입니다. Hashtag Insights에는 해시태그를 찾을 때 사용한 것과 같은 country를 쓰세요.

크리에이터의 시작 단가는 항상 있나요?

단가는 Creator Marketplace 카드의 일부이며, 카드가 있는 크리에이터만 결과를 반환합니다. 다른 SocQ 필드와 마찬가지로 소스가 제공하지 않는 값은 null로 반환됩니다.

결과가 비어 있으면 어떻게 과금되나요?

결과 단위 엔드포인트는 기본 요금이 없으므로 아무것도 반환하지 않은 호출은 비용이 들지 않습니다. Ad Analysis와 Hashtag Insights는 호출 1회당 한 번 과금됩니다.

TIKTOK CREATIVE CENTER API

공개 TikTok Creative Center URL로 워크플로를 테스트하세요

공개 데이터 입력을 제출하면 출처를 추적할 수 있는 컨텍스트가 포함된 정규화된 레코드를 받을 수 있습니다.

TikTok Creative Center API 살펴보기