Skip to main content
GET
cURL

Authorizations

Lovable-API-Key
string
header
required

Lovable API key. Send its value in the Lovable-API-Key header.

Headers

Lovable-Version
string

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

Lovable-Beta
string

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

Path Parameters

project_id
string
required

Project ID.

Query Parameters

starts_at
string<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; the range covers complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at.

Example:

"2026-04-01T00:00:00Z"

ends_at
string<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; the range covers complete UTC calendar dates from the UTC date of starts_at through the UTC date of ends_at.

Example:

"2026-04-08T00:00:00Z"

Response

OK

countries
object[]
required

Top visitor countries by visitor sessions, up to 10 items ordered from highest to lowest. Unknown means the country could not be determined.

devices
object[]
required

Top device types by visitor sessions, up to 10 items ordered from highest to lowest.

pages
object[]
required

Top page paths by visitor sessions, up to 10 items ordered from highest to lowest.

sources
object[]
required

Top referring domains by visitor sessions, up to 10 items ordered from highest to lowest. Direct means no referring domain was recorded.