TikTok Creator Marketplace
TikTok Creator Marketplace 카드는 브랜드가 유료 협업 대상을 검토할 때 보는 크리에이터 프로필로, 소개와 팔로워 수에 더해 팔로워의 연령·성별·국가·기기 구성, 중앙값 조회수, 참여율과 성장률, 협찬 영상에 대해 공개한 시작 단가를 담고 있습니다. 이 카드를 이용하면 브랜드가 오디언스 적합도, 평균적인 성과, 가격을 한 화면에서 크리에이터끼리 비교할 수 있습니다.
TikTok Creator Marketplace API 주요 기능
- 오디언스를 네 가지로 분해audience가 팔로워를 연령대, 성별, 국가, 휴대폰 브랜드로 나누며, 각 항목은 0에서 1 사이의 비중입니다.
- 성과 벤치마크metrics에 followers_count, median_views, engagement_rate, followers_growth_rate, six_second_view_rate가 들어 있습니다.
- 공개된 시작 단가starting_price는 크리에이터가 협찬 영상에 대해 공개한 금액과 통화를 계산에 쓸 수 있는 숫자로 돌려줍니다.
- 요청 한 번에 크리에이터 최대 20명creator_ids에 Creator Marketplace ID를 1~20개 넣으면, 카드가 있는 크리에이터마다 하나씩 반환됩니다.
- 카드마다 신원 정보username, name, 소개 text, avatar_url, region, tiktok_user_id, url, recent_video_ids가 Marketplace ID를 실제 계정에 연결해 줍니다.
TikTok Creator Marketplace API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
creator_ids | 필수 | Creator Marketplace ID 1~20개이며, TikTok Creative Center Top Videos 결과의 creator_id 값 등을 사용합니다. |
TikTok Creator Marketplace API 사용 방법
Top Videos에서 크리에이터 ID를 모은 뒤 카드를 읽습니다.
- TikTok Creative Center Top Videos를 실행해 검토할 크리에이터의 creator_id를 복사합니다.
- {"creator_ids": ["7011198409688219653", "7070293872819044358"]}를 /v1/tiktok-creative-center/creator-cards로 POST합니다.
- status가 succeeded가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 results.items에서 크리에이터별 카드를 읽습니다.
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"]}'
# audience.ages, genders, countries and devices are shares from 0 to 1.TikTok Creator Marketplace API 추천 활용 사례
- 오디언스 적합도 선별: 후보 크리에이터들의 audience.ages, genders, countries를 도달하려는 고객층과 맞춰 보고, 팔로워가 엉뚱한 시장에 몰려 있는 크리에이터는 제외합니다.
- 조회당 비용 비교: 팔로워 수 대신 starting_price.amount를 median_views로 나눠, 크리에이터마다 공개한 단가가 얼마의 조회를 사는지 비교합니다.
- 상승세 순위: 후보 목록을 engagement_rate와 followers_growth_rate로 정렬하면, 반응이 좋고 팔로워도 계속 느는 크리에이터를 찾을 수 있습니다.
TikTok Creator Marketplace API 활용 팁
- ID는 Top Videos 행의 creator_id 필드에서 가져오세요. author.id 같은 TikTok 사용자 ID는 카드와 일치하지 않아 건너뜁니다.
- 오디언스 분포는 합이 1보다 조금 작을 수 있는 비중의 목록으로 보고, 항목은 위치가 아니라 라벨로 맞추세요.
- starting_price.amount는 currency와 함께 읽고, 최종 단가는 프로젝트마다 협의하므로 크리에이터가 제시하는 출발점으로 보세요.
관련 API
TikTok Creator Marketplace 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 Creative Center Top Videos API — 국가별 성과 상위 동영상 차트를 조회수, 참여율과 함께 가져옵니다.