OpenWebTrack

Authentication

You can create and manage API keys in your website settings under the API Keys tab. alt text Pass the API key in the Authorization header as a Bearer token:

Authorization: Bearer owt_your_api_key_here

Retrieve a summary of website traffic and performance for a specific date range.

Endpoint: GET /api/v1/{websiteId}/stats

Query Parameters

Parameter	Type	Required	Description
`startDate`	`string`	No	ISO 8601 date string (e.g., `2026-03-01`). Defaults to 24h ago.
`endDate`	`string`	No	ISO 8601 date string (e.g., `2026-03-31`). Defaults to now.
`granularity`	`string`	No	`hourly`, `daily`, `weekly`, or `monthly`. Defaults to `daily`.

Example Request

curl "https://your-domain.com/api/v1/550e8400-e29b-41d4-a716-446655440000/stats?granularity=daily" 
  -H "Authorization: Bearer owt_..."

Example Response

{
	"summary": {
		"pageviews": 1250,
		"sessions": 450,
		"visitors": 380,
		"bounceRate": 42,
		"dateRange": {
			"start": "2026-03-26T00:00:00.000Z",
			"end": "2026-04-01T23:59:59.999Z"
		}
	},
	"timeSeries": [
		{ "date": "2026-03-26", "pageviews": 9 },
		{ "date": "2026-03-27", "pageviews": 34 }
	],
	"topPages": [
		{ "pathname": "/", "views": 500 },
		{ "pathname": "/blog", "views": 250 }
	],
	"topReferrers": [
		{ "referrer": "google.com", "sessions": 120 },
		{ "referrer": "twitter.com", "sessions": 85 }
	]
}

Error Responses

Status Code	Description
`400`	Invalid request parameters or website ID format.
`401`	Unauthorized - API key is missing or invalid.
`404`	Website not found or API key does not belong to this website.

Notes