Skip to content

Get site analytics

GET
/api/v1/projects/{id}/analytics
curl --request GET \
--url https://api.deploybase.eu/api/v1/api/v1/projects/example/analytics \
--header 'Authorization: <Authorization>'

Daily page views, top pages, referrer hosts, countries, not-found pages and crawlers for a project’s production hosts, aggregated from CDN logs. No IP, user agent or visitor identifier is ever stored. The window ends on the last processed UTC day (data_through) and is clamped to the plan’s history_days.

id
required
string

Project ID

days
integer

Window length in days (1-761, default 30), clamped to the plan

limit
integer

Rows per ranked list (1-100, default 10)

OK

Media type application/json
object
data
meta
object
request_id
string
timestamp
string
trace_id
string
data
object
countries
Array<object>
object
category

Category is set on crawler rows only: ai_training, ai_search, ai_answers, ai (an AI crawler whose operator publishes no purpose), search, seo or monitor (“” for other bots).

string
value
string
views
integer
crawlers
Array<object>
object
category

Category is set on crawler rows only: ai_training, ai_search, ai_answers, ai (an AI crawler whose operator publishes no purpose), search, seo or monitor (“” for other bots).

string
value
string
views
integer
data_through

DataThrough is the last complete UTC day the meter processed, or null before the first.

string
enabled
boolean
history_days

HistoryDays is the plan’s cap on how far back the window may reach.

integer
not_found
Array<object>
object
category

Category is set on crawler rows only: ai_training, ai_search, ai_answers, ai (an AI crawler whose operator publishes no purpose), search, seo or monitor (“” for other bots).

string
value
string
views
integer
pages
Array<object>
object
category

Category is set on crawler rows only: ai_training, ai_search, ai_answers, ai (an AI crawler whose operator publishes no purpose), search, seo or monitor (“” for other bots).

string
value
string
views
integer
referrers
Array<object>
object
category

Category is set on crawler rows only: ai_training, ai_search, ai_answers, ai (an AI crawler whose operator publishes no purpose), search, seo or monitor (“” for other bots).

string
value
string
views
integer
series
Array<object>
object
day
string
page_views
integer
totals
object
crawler_requests
integer
entries
integer
not_found
integer
page_views
integer
window
object
clamped

Clamped is true when the plan’s history cap shortened the requested window.

boolean
days
integer
from
string
requested_days
integer
to
string

Example

{
"data": {
"series": [
{
"day": "2026-09-27"
}
],
"window": {
"days": 30,
"from": "2026-08-29",
"requested_days": 365,
"to": "2026-09-27"
}
}
}

Bad Request

Media type application/json
object
code
string
details
error
string
meta
object
request_id
string
timestamp
string
trace_id
string

Example generated

{
"code": "example",
"details": "example",
"error": "example",
"meta": {
"request_id": "example",
"timestamp": "example",
"trace_id": "example"
}
}

Unauthorized

Media type application/json
object
code
string
details
error
string
meta
object
request_id
string
timestamp
string
trace_id
string

Example generated

{
"code": "example",
"details": "example",
"error": "example",
"meta": {
"request_id": "example",
"timestamp": "example",
"trace_id": "example"
}
}

Not Found

Media type application/json
object
code
string
details
error
string
meta
object
request_id
string
timestamp
string
trace_id
string

Example generated

{
"code": "example",
"details": "example",
"error": "example",
"meta": {
"request_id": "example",
"timestamp": "example",
"trace_id": "example"
}
}

Live 174db30c built