analysis_field_catalog 기준의 1차·하위 카테고리와 표시명을 가져옵니다.
이 호출에는 쿼리 파라미터가 없습니다.
주요 응답dimension_type, value_key, display_name, parent_value_key, mapped_video_count
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/trends/catalog"
JavaScript 예시
const url = new URL("/v1/trends/catalog", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
/v1/creators/7016878198810526725/intelligence내 채널의 실제 분석 영상에서 주요 분야와 전문성을 확인합니다.
이 호출에는 쿼리 파라미터가 없습니다.
주요 응답expertise.sub_categories, analysis_fields, data_through
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/creators/7016878198810526725/intelligence"
JavaScript 예시
const url = new URL("/v1/creators/7016878198810526725/intelligence", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
/v1/creators/7016878198810526725/peer-benchmark같은 분야·팔로워 티어의 비교 집단과 내 위치를 가져옵니다.
파라미터현재 값설명
period_days30점수와 집계를 계산할 누적 분석 기간입니다. 7·30·60·90일을 사용합니다.
start00부터 시작하는 페이지 오프셋입니다.
limit20한 번에 반환할 최대 항목 수입니다. 엔드포인트별 최대값을 OpenAPI에서 확인하세요.
주요 응답category_key, follower_tier, peer_count, avg_views_percentile
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/creators/7016878198810526725/peer-benchmark" \
--data-urlencode "period_days=30" \
--data-urlencode "start=0" \
--data-urlencode "limit=20"
JavaScript 예시
const url = new URL("/v1/creators/7016878198810526725/peer-benchmark", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({
"period_days": 30,
"start": 0,
"limit": 20
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
선택한 하위 카테고리의 기간별 시장 성과를 조회합니다.
파라미터현재 값설명
period_days30점수와 집계를 계산할 누적 분석 기간입니다. 7·30·60·90일을 사용합니다.
facet_typecategory상품·브랜드·고민·클레임·포맷 등 분석 관점 유형입니다.
primary_categorybeautyanalysis_field_catalog의 활성 1차 카테고리 키입니다. 복수값은 쉼표로 구분하며 같은 항목 안에서는 OR입니다.
sub_categorymakeupanalysis_field_catalog의 활성 하위 카테고리 키입니다. 복수값은 쉼표로 구분하며 선택한 1차 카테고리 중 하나에 속해야 합니다.
querymakeup이름·핸들·상품·브랜드 또는 분석 관점에서 찾을 검색어입니다.
start00부터 시작하는 페이지 오프셋입니다.
limit20한 번에 반환할 최대 항목 수입니다. 엔드포인트별 최대값을 OpenAPI에서 확인하세요.
주요 응답trend_score, mention_video_count, creator_count, engagement_rate, score_components
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/trends/radar" \
--data-urlencode "period_days=30" \
--data-urlencode "facet_type=category" \
--data-urlencode "primary_category=beauty" \
--data-urlencode "sub_category=makeup" \
--data-urlencode "query=makeup" \
--data-urlencode "start=0" \
--data-urlencode "limit=20"
JavaScript 예시
const url = new URL("/v1/trends/radar", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({
"period_days": 30,
"facet_type": "category",
"primary_category": "beauty",
"sub_category": "makeup",
"query": "makeup",
"start": 0,
"limit": 20
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
분야 안에서 상승하는 상품·고민·클레임·훅·포맷을 조회합니다.
파라미터현재 값설명
period_days30점수와 집계를 계산할 누적 분석 기간입니다. 7·30·60·90일을 사용합니다.
primary_categorybeautyanalysis_field_catalog의 활성 1차 카테고리 키입니다. 복수값은 쉼표로 구분하며 같은 항목 안에서는 OR입니다.
sub_categorymakeupanalysis_field_catalog의 활성 하위 카테고리 키입니다. 복수값은 쉼표로 구분하며 선택한 1차 카테고리 중 하나에 속해야 합니다.
start00부터 시작하는 페이지 오프셋입니다.
limit100한 번에 반환할 최대 항목 수입니다. 엔드포인트별 최대값을 OpenAPI에서 확인하세요.
주요 응답facet_type, facet_key, trend_score, trend_phase, sample_count
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/trends/radar" \
--data-urlencode "period_days=30" \
--data-urlencode "primary_category=beauty" \
--data-urlencode "sub_category=makeup" \
--data-urlencode "start=0" \
--data-urlencode "limit=100"
JavaScript 예시
const url = new URL("/v1/trends/radar", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({
"period_days": 30,
"primary_category": "beauty",
"sub_category": "makeup",
"start": 0,
"limit": 100
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();
같은 서브카테고리·팔로워 티어에서 평소 대비 성과가 높은 근거 영상을 조회합니다.
파라미터현재 값설명
period_days30점수와 집계를 계산할 누적 분석 기간입니다. 7·30·60·90일을 사용합니다.
primary_categorybeautyanalysis_field_catalog의 활성 1차 카테고리 키입니다. 복수값은 쉼표로 구분하며 같은 항목 안에서는 OR입니다.
sub_categorymakeupanalysis_field_catalog의 활성 하위 카테고리 키입니다. 복수값은 쉼표로 구분하며 선택한 1차 카테고리 중 하나에 속해야 합니다.
follower_tiernano팔로워 수 기준 나노·마이크로·미드·매크로·메가 구간입니다. 복수값은 쉼표로 구분합니다.
sortoutlier서버가 필터 전체 결과에 먼저 적용한 뒤 페이지를 나누는 정렬 기준입니다. 누락값은 마지막에 배치합니다.
start00부터 시작하는 페이지 오프셋입니다.
limit8한 번에 반환할 최대 항목 수입니다. 엔드포인트별 최대값을 OpenAPI에서 확인하세요.
주요 응답outlier_index, view_percentile, outlier_percentile, analysis_facets, sample_count
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/videos/benchmarks" \
--data-urlencode "period_days=30" \
--data-urlencode "primary_category=beauty" \
--data-urlencode "sub_category=makeup" \
--data-urlencode "follower_tier=nano" \
--data-urlencode "sort=outlier" \
--data-urlencode "start=0" \
--data-urlencode "limit=8"
JavaScript 예시
const url = new URL("/v1/videos/benchmarks", process.env.AGENT_API_BASE_URL);
url.search = new URLSearchParams({
"period_days": 30,
"primary_category": "beauty",
"sub_category": "makeup",
"follower_tier": "nano",
"sort": "outlier",
"start": 0,
"limit": 8
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();