API

Query API

The Query API powers every number in the portal — and you can call it directly from your own dashboards, BI tool, or pitchfire.app integration. Every endpoint is tenant-scoped through the token.

Endpoint & auth

GET https://portal.tracera.eu/api/v1/properties/<property_id>/stats/<view>
Authorization: Bearer tk_live_EXAMPLE

Issue a token in the portal under API tokens. Scope it to property, brand, or tenant depending on the breadth your client needs, and pick capabilities like property.read.

Common parameters

Param	Default	Notes
range	`30d`	`today`, `7d`, `30d`, `12m`, or `custom`
from / to	—	Required when `range=custom`; ISO 8601
interval	auto	`minute`, `hour`, `day`, `week`, `month`
limit	50	For top-N endpoints

Endpoints

Base path: https://portal.tracera.eu/api/v1/

Path	Returns
GET /properties	list of properties readable with this token
GET /properties/{id}/stats/overview	visitors, pageviews, bounce rate, avg engagement, live count
GET /properties/{id}/stats/timeseries	per-interval visitors & pageviews
GET /properties/{id}/stats/pages	top URLs by visitors, pageviews, bounce, avg time
GET /properties/{id}/stats/sources	top referrers, UTM source/medium/campaign breakdown
GET /properties/{id}/stats/geo	visitors by country & region
GET /properties/{id}/stats/devices	device type, browser, OS breakdown
GET /properties/{id}/stats/events	custom events with counts
GET /properties/{id}/stats/realtime	last 30 min: count + live event stream

Example

curl https://portal.tracera.eu/api/v1/properties/prp_3f09c2e/stats/timeseries?range=7d&interval=day \
  -H 'Authorization: Bearer tk_live_EXAMPLE'

# Response:
{
  "property_id": "prp_3f09c2e",
  "range": { "from": "2026-06-10T00:00:00Z", "to": "2026-06-17T00:00:00Z" },
  "interval": "day",
  "buckets": [
    { "t": "2026-06-10", "visitors": 4823, "pageviews": 19284 },
    { "t": "2026-06-11", "visitors": 5102, "pageviews": 20418 }
  ]
}

Rate limits

Tokens are rate-limited; concrete limits are subject to change and surfaced in the portal when relevant.