LOlovable
analytics

Get project analytics

Changed on

Plan: Business or higher

Scope: projects:read

Returns website traffic for a published project over a date range as a time series. Date ranges are limited to 365 days, or 31 days with one-hour buckets. Some projects retain analytics for 90 days; older buckets are returned with zero values.

get/v1/projects/{project_id}/analytics

Request

  • Base URL
    https://api.lovable.dev
  • Auth
    • API key in header Lovable-API-Key
    • or HTTP bearer

Path parameters

project_idstring required

Project ID.

Example:prj_01jw3k9m2xq8r5v0c7d4e6f2gh

Query parameters

starts_atstring date-time required

Start of the time range as an RFC 3339 timestamp, such as 2026-04-01T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.

Example:2026-04-01T00:00:00Z
ends_atstring date-time required

End of the time range as an RFC 3339 timestamp, such as 2026-04-08T00:00:00Z. Any offset is accepted and converted to UTC before the range is applied.

Example:2026-04-08T00:00:00Z
granularity'hourly' | 'daily'

Time-bucket size: hourly or daily. Defaults to daily when omitted; any other value returns 400. Daily buckets cover complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at; hourly buckets use the supplied instants inclusively and support at most 31 days.

Example:daily

Headers

Lovable-Versionstring

Stable API version to serve, as a YYYY-MM-DD date. Omit for the oldest supported stable version, currently 2026-09-11.

Lovable-Betastring

Comma-separated beta revision strings to enable on top of the stable version.

Response

OK

Example response

{
  "time_series": {
    "bounce_rate": {
      "data": [
        {
          "timestamp": "2026-01-15T00:00:00Z",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "pageviews": {
      "data": [
        {
          "timestamp": "2026-01-15T00:00:00Z",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "pageviews_per_visit": {
      "data": [
        {
          "timestamp": "2026-01-15T00:00:00Z",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "session_duration": {
      "data": [
        {
          "timestamp": "2026-01-15T00:00:00Z",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    },
    "visitors": {
      "data": [
        {
          "timestamp": "2026-01-15T00:00:00Z",
          "value": 1280
        }
      ],
      "label": "visitors",
      "total": 1280
    }
  }
}

Changes

  • a83f0776a896Revision changes
    • breaking

      added the new required query request parameter ends_at

    • breaking

      added the new required query request parameter starts_at

    • warning

      deleted the query request parameter end_date

    • warning

      deleted the query request parameter start_date

    • info

      for the header request parameter Lovable-Version, the format was generalized from date to no format

    • info

      added the non-success response with the status

  • 63e95b862209Revision changes
    • info

      added the non-success response with the status