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/7629219875084747790/intelligence내 채널의 실제 분석 영상에서 주요 분야와 전문성을 확인합니다.
이 호출에는 쿼리 파라미터가 없습니다.
주요 응답expertise.sub_categories, analysis_fields, data_through
cURL 예시
curl --get --request GET "$AGENT_API_BASE_URL/v1/creators/7629219875084747790/intelligence"
JavaScript 예시
const url = new URL("/v1/creators/7629219875084747790/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/7629219875084747790/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/7629219875084747790/peer-benchmark" \
--data-urlencode "period_days=30" \
--data-urlencode "start=0" \
--data-urlencode "limit=20"
JavaScript 예시
const url = new URL("/v1/creators/7629219875084747790/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차 카테고리 키입니다.
sub_categoryfragranceanalysis_field_catalog의 활성 하위 카테고리 키입니다. 1차 카테고리와 부모 관계가 일치해야 합니다.
queryfragrance이름·핸들·상품·브랜드 또는 분석 관점에서 찾을 검색어입니다.
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=fragrance" \
--data-urlencode "query=fragrance" \
--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": "fragrance",
"query": "fragrance",
"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차 카테고리 키입니다.
sub_categoryfragranceanalysis_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=fragrance" \
--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": "fragrance",
"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차 카테고리 키입니다.
sub_categoryfragranceanalysis_field_catalog의 활성 하위 카테고리 키입니다. 1차 카테고리와 부모 관계가 일치해야 합니다.
follower_tierunder_1k팔로워 수 기준 나노·마이크로·미드·매크로·메가 구간입니다.
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=fragrance" \
--data-urlencode "follower_tier=under_1k" \
--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": "fragrance",
"follower_tier": "under_1k",
"sort": "outlier",
"start": 0,
"limit": 8
}).toString();
const response = await fetch(url, { method: "GET" });
const data = await response.json();