게시된 프로젝트의 웹사이트 트래픽을 날짜 범위별 time series로 조회합니다.

프로젝트 분석 조회

플랜: Business 이상

스코프: projects:read

게시된 프로젝트의 웹사이트 트래픽을 지정한 날짜 범위의 time series로 반환합니다. 날짜 범위는 최대 365일이며, 1시간 bucket을 사용할 때는 최대 31일입니다. 일부 프로젝트는 분석 데이터를 90일 동안 보관하며, 그보다 오래된 bucket은 0 값으로 반환됩니다.

OpenAPI

항목	값
Method	`GET`
Path	`/v1/projects/{project_id}/analytics`
Operation ID	`getProjectAnalytics`
Source spec	`https://api.lovable.dev/v1/openapi.yaml`
Local snapshot	YAML 스냅샷 (SHA-256: `97cc696c72904fc9504473a13ef270006aa241a213d7b9b1f6c4d1b7f1f5c9c1`)

GET /v1/projects/{project_id}/analytics

인증

Lovable-API-Key: lov_your-api-key 또는 Authorization: Bearer <key>를 보냅니다. 이 엔드포인트는 projects:read 스코프가 필요하며 projects:write 스코프도 이 읽기 권한을 포함합니다.

매개변수

이름	위치	필수	타입	설명
`project_id`	path	예	`string`	프로젝트 ID입니다.
`starts_at`	query	예	`string`, `date-time`	시간 범위의 시작입니다. `2026-04-01T00:00:00Z` 같은 RFC 3339 timestamp를 보냅니다. 어떤 오프셋이든 허용되며 범위를 적용하기 전에 UTC로 변환됩니다.
`ends_at`	query	예	`string`, `date-time`	시간 범위의 끝입니다. `2026-04-08T00:00:00Z` 같은 RFC 3339 timestamp를 보냅니다. 어떤 오프셋이든 허용되며 범위를 적용하기 전에 UTC로 변환됩니다.
`granularity`	query	아니요	`string`	시간 bucket 크기입니다. `hourly` 또는 `daily`를 보낼 수 있으며 기본값은 `daily`입니다. 다른 값은 `400`을 반환합니다. daily bucket은 `starts_at`의 UTC 날짜부터 `ends_at`의 UTC 날짜까지 전체 UTC 달력 날짜를 포함합니다. hourly bucket은 전달한 시각을 포함해 적용하며 최대 31일을 지원합니다.
`Lovable-Version`	header	아니요	`string`	제공받을 안정 API 버전입니다. `YYYY-MM-DD` 날짜 형식으로 보냅니다. 생략하면 현재 가장 오래된 지원 안정 버전인 `2026-09-11`이 사용됩니다.
`Lovable-Beta`	header	아니요	`string`	안정 버전 위에 활성화할 베타 리비전 문자열입니다. 여러 개는 쉼표로 구분합니다.

예시

curl --request GET \
  --url 'https://api.lovable.dev/v1/projects/project-id/analytics?ends_at=2026-04-08T00:00:00Z&starts_at=2026-04-01T00:00:00Z' \
  --header 'Lovable-API-Key: lov_your-api-key' \
  --header 'Lovable-Version: 2026-09-11'

const response = await fetch("https://api.lovable.dev/v1/projects/project-id/analytics?ends_at=2026-04-08T00:00:00Z&starts_at=2026-04-01T00:00:00Z", {
  method: "GET",
  headers: {
    "Lovable-API-Key": process.env.LOVABLE_API_KEY ?? "lov_your-api-key",
    "Lovable-Version": "2026-09-11",
  },
});
if (!response.ok) {
  throw new Error(`Lovable API ${response.status}: ${await response.text()}`);
}
console.log(await response.json());

응답

상태	본문	설명
`200`	`ProjectAnalytics`	요청이 성공했습니다.
`400`	`ErrorResponse`	요청 본문 또는 매개변수 형식이 잘못되었거나 검증에 실패했습니다. 실패한 각 필드는 `errors`에 나열됩니다.
`401`	`ErrorResponse`	API 키, 세션 토큰 또는 OAuth access token이 없거나 유효하지 않습니다.
`402`	`ErrorResponse`	Public API 접근에는 Business 이상 플랜이 필요합니다. 일부 작업 또는 설정에는 추가 기능 권한이 필요할 수 있습니다.
`403`	`ErrorResponse`	키 또는 호출자에게 필요한 스코프나 권한이 없습니다.
`404`	`ErrorResponse`	프로젝트가 존재하지 않거나 삭제되었거나 인증된 클라이언트가 접근할 수 없습니다. 프로젝트가 게시되어 있지 않아도 분석을 사용할 수 없으므로 `404`가 반환됩니다.
`406`	`ErrorResponse`	`Accept` 헤더가 이 엔드포인트가 생성하는 모든 미디어 타입을 제외합니다.
`429`	`ErrorResponse`	요청이 너무 많습니다. `Retry-After`가 있으면 해당 간격 뒤에 재시도합니다.
`503`	`ErrorResponse`	서비스를 일시적으로 사용할 수 없거나 처리 기한이 만료되었습니다.
`default`	`ErrorResponse`	오류입니다. 응답 본문은 표준 오류 envelope을 사용하며 `status`는 HTTP 상태 코드와 같고 `type`은 machine-readable 오류 코드입니다.

모든 응답에는 상황에 따라 다음 공통 헤더가 포함될 수 있습니다: Lovable-Version, Lovable-Beta, X-Request-Id, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Lovable-Unknown-Query-Params, X-Lovable-Unknown-Query-Params-Omitted. X-Lovable-Unknown-Query-Params는 이 작업이 선언하지 않은 query parameter가 있을 때 URL escape된 이름을 최대 20개까지 쉼표로 제공하며, 20개를 넘으면 X-Lovable-Unknown-Query-Params-Omitted가 누락된 개수(minimum: 1)를 제공합니다. 401 응답은 string인 WWW-Authenticate를, 429 응답은 integer인 Retry-After를 포함합니다. Retry-After는 minimum: 1입니다. X-RateLimit-Reset은 지연 시간이 아니라 Unix timestamp 초 단위입니다.

스키마

`ProjectAnalytics`

필드	타입	필수	설명
`time_series`	`TimeSeriesGroup`	예	요청한 날짜 범위의 웹사이트 트래픽 지표입니다.

`TimeSeriesGroup`

필드	타입	필수	설명
`visitors`	`TimeSeriesData`	예	방문자 세션입니다. bucket마다 한 번씩 계산됩니다. `total`은 bucket 수를 합산하므로 여러 bucket에서 활동한 한 세션이 한 번 이상 계산될 수 있습니다.
`pageviews`	`TimeSeriesData`	예	페이지뷰입니다. 각 data point는 해당 bucket의 페이지뷰 수이고 `total`은 요청 범위 전체의 합계입니다.
`pageviews_per_visit`	`TimeSeriesData`	예	방문당 페이지뷰입니다. 각 data point는 해당 bucket의 비율이고 `total`은 범위 전체 페이지뷰를 전체 방문자 수로 나눈 값입니다. bucket별 비율의 평균이 아닙니다.
`session_duration`	`TimeSeriesData`	예	평균 세션 길이입니다. 단위는 초입니다. 각 data point는 해당 bucket의 평균 세션 길이이고 `total`은 방문자가 1명 이상 있었던 bucket 값의 평균을 정수 초로 반올림한 값입니다. 합계가 아닙니다.
`bounce_rate`	`TimeSeriesData`	예	이탈률입니다. 백분율 `0`부터 `100`까지의 값입니다. 각 data point는 해당 bucket의 비율이고 `total`은 방문자가 1명 이상 있었던 bucket의 평균입니다.

`TimeSeriesData`

필드	타입	필수	설명
`total`	`number`, `double`	예	요청 범위의 집계값입니다. 단위와 계산 방식은 부모 지표가 정의합니다.
`label`	`string`	예	`session_duration` 같은 지표 식별자입니다.
`data`	`TimeSeriesDataPoint[]`	예	bucket 시작 시각순으로 정렬된 값입니다. bucket 크기는 `granularity`가 정하며 미래 bucket은 포함되지 않습니다.

`TimeSeriesDataPoint`

필드	타입	필수	설명
`timestamp`	`string`, `date-time`	예	UTC 기준 bucket 시작 시각입니다. RFC 3339 형식입니다.
`value`	`number`, `double`	예	부모 지표가 정의한 단위에서 이 bucket의 지표 값입니다.

`ErrorResponse`

공통 오류 응답입니다.

필드	타입	필수	설명
`detail`	`string \	null`	예
`errors`	`array \	null`	예
`props`	`object \	null`	예
`request_id`	`string`	예	`X-Request-Id` 응답 헤더에서 반복되는 이 요청의 식별자입니다.
`status`	`integer`	예	본문에 반복되는 HTTP 상태 코드입니다.
`title`	`string`	예	사람이 읽을 수 있는 오류 요약입니다.
`type`	`string`	예	안정적인 machine-readable 오류 유형입니다.

원본에 포함된 이 작업의 OpenAPI 스냅샷은 YAML 스냅샷 (SHA-256: 97cc696c72904fc9504473a13ef270006aa241a213d7b9b1f6c4d1b7f1f5c9c1)로 보존했습니다. 최신 전체 OpenAPI 계약은 https://api.lovable.dev/v1/openapi.yaml에서 확인할 수 있습니다.

On this page