CICreator Intelligence
US TikTok Beauty Intelligence
Data through 2026-08-05사용 가능
Developer Experience

Agent API 활용 가이드

이 웹서비스의 각 화면이 어떤 API와 파라미터로 만들어지는지 확인하고, 다른 서비스에 적용할 수 있는지 판단하세요.

내부 API는 서버 간 연결을 권장합니다.

현재 웹은 Nuxt 서버 프록시를 통해 agent-api에 접근합니다. 다른 서비스에서도 브라우저에 내부 주소를 노출하지 말고, 백엔드 또는 BFF에서 호출하세요. 인증 방식은 배포 환경의 서비스 인증 정책과 함께 확정해야 합니다.

Choose by job

무엇을 만들지 먼저 선택하세요

프로필 하나가 아니라 의사결정 흐름별로 여러 목적 API를 조합합니다.

제품에 맞는 크리에이터 찾기

이 제품을 실제로 잘 다루는 후보는 누구인가?

  1. 자연어 또는 구조화 필터로 후보 검색
  2. 크리에이터별 인텔리전스와 예상 비용 조회
  3. 근거 영상으로 추천 이유 검증
/v1/recommendations/creators/by-natural-language/v1/creators/{creatorId}/intelligence/v1/creators/{creatorId}/evidence-videos/v1/creators/{creatorId}/pricing

뷰티 트렌드 레이더 만들기

무엇이 막 떠오르고, 누구에게 확산되고 있는가?

  1. 7·30·60·90일 창으로 트렌드 비교
  2. 카테고리·상품·클레임·포맷 등 관점 선택
  3. 연관 관점과 과거 이력 연결
/v1/trends/catalog/v1/trends/radar/v1/trends/relations/v1/trends/history

상품·브랜드 콘텐츠 전략

이 상품은 어떤 방식과 누구를 통해 주목받는가?

  1. 상품 관심 급상승 순위 조회
  2. 상품별 적합 크리에이터 조회
  3. 성과가 좋은 포맷·훅·메시지 확인
/v1/trends/products/v1/products/{productId}/v1/products/{productId}/creators/v1/products/{productId}/promotion-patterns

크리에이터 개인화 성장

전체 시장을 내 채널의 관점에서 어떻게 활용할 수 있는가?

  1. 내 카테고리·규모의 동료 기준과 비교
  2. 시장 트렌드에서 콘텐츠 공백과 강점 확장 주제 발견
  3. 성과가 높은 영상 근거로 콘텐츠 브리프 생성
/v1/creators/{creatorId}/peer-benchmark/v1/creators/{creatorId}/growth-opportunities/v1/videos/benchmarks/v1/creators/{creatorId}/content-briefs

리포트와 데이터 품질

이 인사이트를 의사결정에 사용해도 되는가?

  1. 주간 분석 요약과 근거 통계 조회
  2. 기준일·표본·커버리지 확인
  3. 지연·제한 상태를 제품 화면에 표시
/v1/insights/weekly-brief/v1/insights/data-status
Integration decision

도입 전 확인할 것

  • 목적검색 목록, 상세 분석, 트렌드 중 필요한 응답을 분리해 호출합니다.
  • 최신성data_through와 refreshed_at을 캐시 키와 화면에 함께 보관합니다.
  • 신뢰도score만 저장하지 말고 표본·커버리지·제한사항을 함께 전달합니다.
  • 판매 해석콘텐츠 관심과 실제 판매·전환을 분리합니다.
  • 네트워크내부 API는 서버 간 프록시 또는 같은 사설망에서 연결합니다.
  • 카테고리GET /v1/trends/catalog의 primary_category·sub_category만 사용합니다. 하위 분류만 보내면 API가 부모를 결정합니다.
  • 정렬sort는 필터가 적용된 전체 결과를 정렬한 뒤 페이지를 나눕니다. 지원하지 않는 값은 INVALID_SORT로 거부됩니다.
  • 타임아웃일반 API 요청은 최대 30초입니다. 시간 초과는 504, agent-api 연결 실패는 503으로 구분합니다.
  • 관측 GMVobserved_gmv_desc는 GMV가 관측된 일부 표본만 정렬하며 실제 전체 판매 순위가 아닙니다.
Response contract

공통 신뢰 메타데이터

?
데이터 신뢰 정보

점수의 표본, 커버리지, 출처, 기준일과 제한사항을 함께 전달합니다.

활용
score만 사용하지 말고 confidence, sample_count, coverage_ratio, data_through를 함께 저장하고 표시하세요.
주의
available은 원천이 최신이라는 뜻과 같지 않습니다. freshness_status를 별도로 확인해야 합니다.
API 필드
confidence, sample_count, coverage_ratio, data_source, data_through, limitations
Score dictionary

점수와 제한사항

?를 열어 계산식, 활용법과 API 필드를 확인하세요.

시딩 적합도
?
시딩 적합도

제품을 보냈을 때 콘텐츠 주제와 제작 역량이 얼마나 잘 맞는지 설명하는 종합 점수입니다.

계산
상품 관련성 40% + 콘텐츠 품질 25% + 활동 준비도 20% + 성장 잠재력 15%
활용
구성요소와 근거 영상을 함께 보고 후보 간 우선순위를 정하는 용도입니다.
주의
수락·게시 확률이 아닙니다. 누락 항목은 0점 대신 사용 가능한 항목만 재가중합니다.
API 필드
creator_seeding_fit_score
콘텐츠 품질
?
콘텐츠 품질

팔로워 규모보다 실제 조회 효율과 콘텐츠 제작 특성을 중심으로 비교합니다.

계산
조회 효율 30% + 참여율 20% + 시각 품질·훅 20% + 오가닉 표현·제작 안정성 20% + 게시 지속성 10%
활용
규모가 다른 크리에이터를 동일 비교 집단의 백분위로 비교합니다.
주의
오디언스 진위나 가짜 팔로워 판정 점수는 포함하지 않습니다.
API 필드
creator_quality_score
활동 준비도
?
활동 준비도

최근에도 꾸준히 게시하고 브랜드 콘텐츠를 만들 준비가 되어 있는지를 보여줍니다.

계산
검증된 외부 posting 신호 40% + 최근 게시 빈도 30% + 협업 경험 15% + 최근 활동 15%
활용
관련성과 별도로 실제 활성 상태를 확인하는 보조 지표입니다.
주의
외부 posting 신호의 단위가 확인되지 않으면 해당 항목을 제외하고 재가중합니다.
API 필드
activation_readiness_score
성장 잠재력
?
성장 잠재력

현재 규모에 비해 조회와 참여가 얼마나 빠르게 커지는지 나타냅니다.

계산
팔로워·조회 성장 30% + 팔로워 대비 조회 효율 40% + 참여율 20% + 게시 지속성 10%
활용
이미 큰 계정보다 규모 대비 성과가 좋은 신규 관측·급성장 계정을 찾는 데 적합합니다.
주의
신규는 계정 생성일이 아니라 데이터에서 처음 관측된 시점을 의미합니다.
API 필드
breakout_score 또는 rank_score
상품 적합도
?
상품 적합도

특정 상품을 실제로 얼마나 자주, 잘 다뤘는지 평가합니다.

계산
관련 영상 비중 35% + 본인 평균 대비 조회 30% + 관련 영상 참여율 20% + 콘텐츠 제작 적합성 15%
활용
상품별 크리에이터 추천 순위를 만들 때 사용합니다.
주의
본인 평균 대비 조회 성과는 2배에서, 참여율은 10%에서 상한 처리합니다.
API 필드
fit_score
상품 관심도
?
상품 관심도

상품 관련 콘텐츠가 최근 얼마나 빠르게 주목받는지 나타냅니다.

계산
언급 증가 35% + 조회 속도 30% + 참여 크리에이터 증가 20% + 참여율 15%
활용
점수가 높을수록 콘텐츠 관심이 빠르게 확산되는 상품입니다.
주의
Amazon 판매량이나 ROAS가 아닙니다. GMV 미관측 영상은 0원으로 계산하지 않습니다.
API 필드
attention_score 또는 trend_score
뷰티 트렌드 점수
?
뷰티 트렌드 점수

콘텐츠에서 얼마나 빠르고 넓게 관심이 커지는지를 0~100으로 비교한 점수입니다.

계산
언급 증가 25% + 조회 속도 25% + 참여 크리에이터 증가 20% + 참여율 15% + 신규 참여자 10% + 지속성 5%
활용
같은 기간과 비교 집단 안에서 상대적으로 해석합니다. 7일과 90일 점수를 함께 보면 단기 가속과 지속성을 구분할 수 있습니다.
주의
실제 판매량, 전환율 또는 시장점유율을 의미하지 않습니다. 영상 20개·크리에이터 5명 미만은 제한된 신호입니다.
API 필드
trend_score
트렌드 연관도
?
트렌드 연관도

두 분석 관점이 같은 영상과 크리에이터에서 얼마나 자주 함께 나타났는지 보여줍니다.

계산
공동 영상 수 × ln(1 + 공동 크리에이터 수)
활용
값이 클수록 함께 등장한 근거가 많습니다.
주의
0~100 점수가 아니므로 다른 점수와 직접 비교하지 않습니다.
API 필드
relation_score
개인화 성장 기회 점수
?
개인화 성장 기회 점수

시장 흐름이 내 채널 주제와 얼마나 맞고 실제 고성과 영상 근거가 있는지 비교합니다.

계산
시장 모멘텀 35% + 크리에이터 적합성 30% + 동료 영상 근거 20%. 사용할 수 없는 항목은 제외하고 재가중합니다.
활용
점수가 높은 주제부터 왜 지금·왜 나에게·근거 영상을 함께 확인해 다음 콘텐츠 우선순위를 정합니다.
주의
예상 조회수나 미래 성장 확률이 아닙니다. 광고 포화도 원천은 현재 점수에 포함하지 않습니다.
API 필드
opportunity_score, score_components
내 콘텐츠 공백
?
내 콘텐츠 공백

내 주요 카테고리에서는 상승하지만 최근 내 콘텐츠에서 정확히 다룬 근거가 부족한 주제입니다.

활용
콘텐츠 공백은 새롭게 시도할 후보, 강점 확장은 이미 잘 다룬 주제를 더 깊게 만들 후보로 사용합니다.
주의
다루지 않았다는 완전한 판정이 아니라 현재 수집·분석된 영상 표본을 기준으로 한 분류입니다.
API 필드
score_components.creator_fit, matched creator facets
평소 대비 성과
?
평소 대비 성과

영상 조회수를 해당 크리에이터의 같은 기간 영상 중앙 조회수로 나눈 배수입니다.

계산
영상 조회수 ÷ 크리에이터의 동일 기간 중앙 조회수
활용
1배보다 크면 평소보다 높은 조회 성과이며, 규모가 다른 크리에이터의 이례적 성과를 찾는 데 사용합니다.
주의
기준 영상이 3개 미만이면 변동이 크므로 confidence와 표본 수를 함께 확인해야 합니다.
API 필드
outlier_index, creator_median_views, creator_baseline_video_count
카테고리·티어 백분위
?
카테고리·티어 백분위

같은 분석 기간·하위 카테고리·팔로워 티어 안에서 영상 성과의 상대 위치입니다.

활용
95백분위는 비교 집단 영상 중 상위 약 5% 수준이라는 의미입니다.
주의
플랫폼 전체 영상이 아니라 수집·분석된 비교 표본 기준이며 판매 성과를 의미하지 않습니다.
API 필드
view_percentile, outlier_percentile, sample_count
동료 대비 백분위
?
동료 대비 백분위

같은 하위 카테고리와 팔로워 티어의 크리에이터 사이에서 내 성과 위치를 보여줍니다.

활용
조회·참여·성장·게시 지속성을 각각 비교해 강점과 보완점을 찾습니다.
주의
성별·연령은 과도한 세분화를 피하기 위해 동료 그룹 정의에 사용하지 않습니다.
API 필드
avg_views_percentile, engagement_percentile, growth_percentile, posting_consistency_percentile
예상 포스팅 비용
?
예상 포스팅 비용

팔로워, 평균 조회, 참여와 실제 계약 표본을 바탕으로 계산한 예상 범위입니다.

활용
협상 전 예산 범위를 잡는 참고값이며 상세 응답의 산정 근거와 신뢰도를 함께 확인합니다.
주의
확정 견적이나 계약 금액이 아닙니다. 사용권, 독점, 수정 횟수와 제작 난이도는 별도 협의가 필요합니다.
API 필드
estimated_fee_low, estimated_fee_mid, estimated_fee_high
데이터 신뢰 정보
?
데이터 신뢰 정보

점수의 표본, 커버리지, 출처, 기준일과 제한사항을 함께 전달합니다.

활용
score만 사용하지 말고 confidence, sample_count, coverage_ratio, data_through를 함께 저장하고 표시하세요.
주의
available은 원천이 최신이라는 뜻과 같지 않습니다. freshness_status를 별도로 확인해야 합니다.
API 필드
confidence, sample_count, coverage_ratio, data_source, data_through, limitations
Endpoint catalog

목적별 엔드포인트

전체 요청·응답 스키마는 Swagger UI 또는 OpenAPI JSON에서 확인할 수 있습니다.

크리에이터 탐색

GET/v1/creators/search필수 목록 중심의 구조화 검색
GET/v1/recommendations/creators/by-natural-language자연어 브리프 기반 추천
GET/v1/creators/video-previews목록 카드용 대표 영상

크리에이터 상세

GET/v1/creators/{creatorId}프로필과 기본 성과
GET/v1/creators/{creatorId}/intelligence점수 구성요소·추천 근거
GET/v1/creators/{creatorId}/evidence-videos분석 근거 영상
GET/v1/creators/{creatorId}/pricing예상 포스팅 비용
GET/v1/creators/{creatorId}/history최근 일별·과거 월별 이력

트렌드·상품

GET/v1/trends/creators크리에이터 트렌드
GET/v1/trends/products상품 관심 트렌드
GET/v1/trends/radar뷰티 분석 관점별 트렌드
GET/v1/trends/relations함께 상승한 관점
GET/v1/products/{productId}/promotion-patterns포맷·훅·메시지

개인화 성장

GET/v1/creators/{creatorId}/peer-benchmark동일 카테고리·규모 동료 비교
GET/v1/creators/{creatorId}/growth-opportunities콘텐츠 공백·강점 확장 주제
GET/v1/videos/benchmarks카테고리별 고성과 영상 근거
POST/v1/creators/{creatorId}/content-briefs근거 기반 콘텐츠 브리프 생성
Quickstart

첫 요청 실행하기

AGENT_API_BASE_URL에는 사설망에서 접근 가능한 agent-api 주소를 설정합니다.

검색과 개인화 성장 API 예시GET 조회와 POST 브리프 생성 예시를 복사해 서버 환경에서 실행하세요.2개 호출
GET/v1/recommendations/creators/by-natural-language

제품과 원하는 콘텐츠 방식을 자연어로 설명해 크리에이터 후보를 찾습니다.

파라미터현재 값설명
query_text민감성 피부에 세라마이드 크림을 자연스럽게 리뷰하는 크리에이터자연어로 작성한 크리에이터 조건입니다. 한국어·영어 1~500자를 지원합니다.
recent_days90추천 근거 영상으로 사용할 최근 게시 기간입니다.
start00부터 시작하는 페이지 오프셋입니다.
limit20한 번에 반환할 최대 항목 수입니다. 엔드포인트별 최대값을 OpenAPI에서 확인하세요.
주요 응답items, total_count, score, reason, evidence_video_ids
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/recommendations/creators/by-natural-language" \
  --data-urlencode "query_text=민감성 피부에 세라마이드 크림을 자연스럽게 리뷰하는 크리에이터" \
  --data-urlencode "recent_days=90" \
  --data-urlencode "start=0" \
  --data-urlencode "limit=20"
JavaScript 예시
const url = new URL("/v1/recommendations/creators/by-natural-language", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({
  "query_text": "민감성 피부에 세라마이드 크림을 자연스럽게 리뷰하는 크리에이터",
  "recent_days": 90,
  "start": 0,
  "limit": 20
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
POST/v1/creators/{creatorId}/content-briefs

선택한 크리에이터와 시장 주제를 연결한 촬영 가능한 콘텐츠 브리프를 생성합니다.

이 호출에는 쿼리 파라미터가 없습니다.

요청 본문
{
  "objective": "reach",
  "facet_type": "category",
  "facet_key": "skincare",
  "period_days": 30
}
주요 응답title, hooks, production_steps, evidence_videos, limitations
cURL 예시
curl --request POST "$AGENT_API_BASE_URL/v1/creators/{creatorId}/content-briefs" \
  --header "Content-Type: application/json" \
  --data '{"objective":"reach","facet_type":"category","facet_key":"skincare","period_days":30}'
JavaScript 예시
const url = new URL("/v1/creators/{creatorId}/content-briefs", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({}).toString();
const response = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({
  "objective": "reach",
  "facet_type": "category",
  "facet_key": "skincare",
  "period_days": 30
}) });
const data = await response.json();