API
오픈 API
모갈릭이 수집한 트렌드·검색·토픽 데이터를 읽기 전용 REST API로 제공합니다. 아래에서 API 키를 발급받아 바로 사용하세요.
엔드포인트
현재 트렌드 순위
파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| segmentKey | string | 선택 | 세그먼트 키. 지정하면 해당 세그먼트만 필터링 |
| category | string | 선택 | 카테고리 코드 필터 (예: ISSUE, NEWS, DRAMA, MOVIE, MUSIC, TREND, YOUTUBE, SHOPPING) |
| period | string | 선택 | 집계 기간. daily / weekly / monthly (기본값 daily) |
| perCategory | integer | 선택 | 카테고리별 최대 반환 개수. 지정 시 카테고리마다 이 수만큼만 반환 |
| limit | integer | 선택 | 전체 결과 개수 상한. 1~100 (기본값 20) |
응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
| topicId | UUID | 토픽 식별자 |
| label | string | 토픽 표시명 |
| categoryCode | string | 카테고리 코드 |
| segmentKey | string | 세그먼트 키 |
| score | number | TrendScore 계산값 |
| rank | integer | 현재 순위 |
| previousRank | integer | null | 직전 집계 순위. 이번에 처음 진입했으면 null |
| sourceCount | integer | 순위 산출 근거가 된 소스 개수 |
| calculatedAt | datetime | 점수 계산 시각 (ISO-8601) |
인증
모든 요청 헤더에 발급받은 키를 X-API-Key로 전달하세요.
curl -H "X-API-Key: mgk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \ "http://localhost:8090/open/v1/trends?period=daily&limit=20"
분당 요청 수는 키별로 제한됩니다(기본 60회). 초과하면
429 응답과 Retry-After 헤더가 내려옵니다.모든 응답에 X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset 헤더가 포함됩니다.내 API 키
API 키 발급은 Google 로그인 후 가능합니다.