API Reference · 리포트

활성 사용자 리포트

콘텐츠사가 자기 콘텐츠를 사용한 활성 사용자(MAU/DAU) 집계를 조회합니다. 일자별·매체별로 그룹화 가능합니다.

GET/api/v1/reports/users

요청 파라미터

from (query, date, required) — 조회 시작일 (YYYY-MM-DD).
to (query, date, required) — 조회 종료일 (YYYY-MM-DD, inclusive).
group_by (query, string, default day) — day / week / month / publisher.
content_id (query, uuid, optional) — 특정 콘텐츠로 필터.
publisher_id (query, uuid, optional) — 특정 매체사로 필터.

요청예시

shell

curl -H "Authorization: Bearer {provider_secret}" \
     "https://added.blomics.net/api/v1/reports/users?from=2026-04-01&to=2026-04-30&group_by=day"

응답 필드

items (array) — 그룹별 집계 행.
- bucket (string) — 그룹 키 (날짜 또는 ID, group_by 에 따라).
- active_users (int) — 고유 publisher_user_id 수.
- new_users (int) — 해당 구간 첫 등장 사용자 수.
- sessions (int) — 세션 수.
summary (object) — 전체 합계.
- active_users (int)
- new_users (int)
- sessions (int)

응답예시

json

{
  "items": [
    { "bucket": "2026-04-01", "active_users": 1234, "new_users": 240, "sessions": 1801 },
    { "bucket": "2026-04-02", "active_users": 1310, "new_users": 198, "sessions": 1922 }
  ],
  "summary": { "active_users": 2544, "new_users": 438, "sessions": 3723 }
}

에러처리

400 INVALID_PARAM — 기간 형식 오류, from 이 to 보다 큼, 최대 기간(예: 90일) 초과.
401 UNAUTHORIZED — 인증 실패.
500 INTERNAL_ERROR — 서버 오류.