tiktok-creative-center/
creator-cards

크리에이터 ID 최대 20개로 TikTok Creator Marketplace 카드를 조회해 팔로워의 연령·성별·국가·기기 비중, 중앙값 조회수, 참여율, 시작 단가를 받습니다.

TikTok Creator Marketplace API

크리에이터 최대 20명
오디언스 분포
시작 단가
결과당 0.5 크레딧
준비됨
준비됨

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

README

SocQ 작성 · 업데이트

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를 모은 뒤 카드를 읽습니다.

  1. TikTok Creative Center Top Videos를 실행해 검토할 크리에이터의 creator_id를 복사합니다.
  2. {"creator_ids": ["7011198409688219653", "7070293872819044358"]}를 /v1/tiktok-creative-center/creator-cards로 POST합니다.
  3. 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와 함께 읽고, 최종 단가는 프로젝트마다 협의하므로 크리에이터가 제시하는 출발점으로 보세요.

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

다른 플랫폼 둘러보기

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

TikTok Creator Marketplace API — 자주 묻는 질문

TikTok Creator Marketplace API는 Creator Marketplace ID로 최대 20명 크리에이터의 TikTok Creator Marketplace 카드를 조회하는 프로그래밍 인터페이스입니다. 팔로워의 연령·성별·국가·기기 분포, 중앙값 조회수, 참여율·성장률, 시작 단가, 크리에이터 신원 정보를 반환합니다.

Top Videos 행에서 creator_id로 돌아오는 Creator Marketplace ID로, 5~32자리 숫자입니다. 일반 TikTok 사용자 ID로는 카드를 찾을 수 없고, 다른 형식은 400 오류로 거부됩니다.

TikTok Creator Marketplace에 가입해 프로필을 만든 크리에이터입니다. 연령이나 팔로워 기준 등 자격 요건은 TikTok이 정하며 프로젝트마다 다릅니다. 카드가 없는 ID는 건너뛰고 청구하지 않으며, 모든 ID를 건너뛰면 작업이 실패하고 크레딧이 환불됩니다. 반환된 카드 1장당 0.5 크레딧입니다.

크리에이터 팔로워를 나눈 네 가지 분포로, 18-24나 55+ 같은 라벨이 붙은 연령대, 성별, 국가, 휴대폰 브랜드이며 항목마다 0~1의 비중이 있습니다. 국가에는 country_code와 표본 팔로워 수도 들어 있습니다.

starting_price가 크리에이터가 협찬 영상의 시작 가격으로 공개한 금액과 통화를 알려 줍니다. 출발점이 되는 금액이며, 시작 단가는 크리에이터가 직접 정하고 최종 가격은 프로젝트마다 협의합니다.

아니요, Creator Marketplace ID로만 조회합니다. 후보는 TikTok Creative Center Top Videos에서 찾으세요. 모든 차트 행에 creator_id가 들어 있습니다.

TikTok 쪽에서는 필요 없습니다. SocQ API 키만으로 조회하며, 브랜드 계정이나 파트너 승인은 관여하지 않습니다.