API for utviklere og AI-verktøy

Sporløs har et read-only Stats-API så du kan hente tallene dine inn i rapporter, regneark og AI-verktøy. Det er trygt å dele en nøkkel med en AI-assistent: API-et serverer kun aggregater — enkeltpersoner kan ikke slås opp, fordi rådataene ikke finnes (ingen IP, ingen cookie, daglig-roterende hash).

Kom i gang

Lag en nøkkel under «API-tilgang» i dashbordet, og send den som Bearer-token:

curl -H "Authorization: Bearer sl_..." \
  "https://sporlos.no/api/v1/stats?site=DIN_SITE_ID&period=7"

site er nettstedets public-ID (samme som i sporings-snippeten — eller hent alle med /api/v1/sites). period er 1, 7 eller 30 dager.

Endepunkter

GET /api/v1/sites	nettstedene dine (domene + site-ID)
GET /api/v1/stats	KPI-er (unike, visninger, økter, fluktrate) + topplister, med forrige periode til sammenligning
GET /api/v1/timeseries	per dag (per time når period=1)
GET /api/v1/breakdown	full liste per dimensjon: prop=pages|sources|countries|regions|devices|browsers|os (+ limit, maks 1000)
GET /api/v1/goals	mål/konverteringer med rate
GET /api/v1/events	egendefinerte hendelser
GET /api/v1/anchors	forseglede dags-aggregater: sha256-hash + blokkjede-txid — bevis på at historiske tall ikke er endret i etterkant

Alle svar er JSON. Land returneres som ISO-koder. Feil gir {"error": "..."} med 400/401/404. Nøkler kan trekkes tilbake når som helst i dashbordet.

Eksempel: spør en AI om tallene dine

Lim denne siden + nøkkelen din inn i Claude eller ChatGPT og be den f.eks. «hent siste 30 dager for nettstedet mitt og forklar hva som driver trafikken». Verktøy som kan gjøre HTTP-kall trenger ikke mer enn dette.