Data API

Hva du får

Tallene over telles fra live-speca hver gang siden lastes — de kan ikke bli utdaterte. Vil du ha listen selv: GET /discovery for produktkatalogen, GET /docs/json for hele OpenAPI-speca.

Hva som ikke er med

Dette står her fordi det er lettere å planlegge rundt et hull du kjenner:

• Områdeanalyse og markedsaggregater (/analysis/*) — trukket ut 2026-08-31. Alle 38 rutene svarer 404 og er ute av speca. De var proxy-et fra PropClouds private flate og svarte 502 fra dag én. Omsetnings- og prisanalyse per eiendom finnes (/property/transaction/*, /valuation/*); aggregater per kommune, rutenett eller bbox gjør ikke.
• Personsøk, eierskapstre-per-person og UBO (/person/search, /person/info/*, /person/companies/*, /person/ownership/*, /person/housing-company/*) — samme uttrekk, 19 ruter, alle 404. Eierskapstrær for selskap og eiendom finnes fortsatt under company:read/property:read; det er UBO-oppløsningen som mangler.
• De fem gjenstående /person/*-rutene er bevisst holdt utenfor referansen under. De krever person:read og signert databehandleravtale — ta kontakt, ikke gjett på kontrakten.
• Geo står som coming_soon i /discovery. Rutene er publisert, men flere av dem er stubber — sjekk /specs/geo/ai-context.md før du bygger på dem.

Fasit er alltid live-flaten: /discovery sier hvilke produkter som finnes og med hvilken status, og /specs/{produkt}/ai-context.md sier hva som er tatt ut og hvorfor.

Hvorfor det finnes

Norske eiendomsdata bor i et halvt dusin leverandører. Hver har egen auth, egne ID-systemer, egne særegenheter. Å integrere én tar et par dager. Å integrere alle er et prosjekt. Denne API-en gjør integrasjonen én gang, på vår side, så du slipper.

• Én kanonisk ID. Kartverket NMA-streng (0301-207-80-0-0) for eiendom, organisasjonsnummer for selskap. Gatewayen oversetter til backend-spesifikke ID-er internt.
• Per-kall kostnadsåpenhet. Hvert svar har x-call-weight og periodiske totaler. Ingen overraskelsesregninger.
• AI-klar fra dag én. /discovery returnerer en JSON-katalog med per-produkt ai-context.md-filer som passer rett inn i en LLM-prompt.

Quick start

Når du er logget inn (knapp over), klikk Try it under hvert kall — forespørselen sendes mot live-gatewayen med din token og svaret vises rett her.

Hva det låser opp

Akkvisisjon	Adressesøk → eierskap → omsetningshistorikk → BREEAM/Enova → leietakere — fire kall, full bilde av eiendommen
Markedsanalyse	Omsetningshistorikk per matrikkelenhet og per eier, AVM-estimat, indeksert pris, sammenliknbare salg og Finn.no-annonser — per eiendom, ikke som områdeaggregat
Eierstruktur	Eierskapstrær for selskap (/company/get-company-owners-tree) og eiendom (/property/panel/{nma}/ownership-tree), boligselskap og sameier
AI-agenter	/discovery + per-produkt ai-context.md gjør at en LLM kan navigere API-en uten ekstra wrapping. Vi har demo-validert dette med Opus 4.7

Auth

Hvert endepunkt under /property/*, /company/* osv. krever en bearer-JWT. Token-ens scope-claim styrer hvilke produkter du når (f.eks. property:read company:read). Offentlige overflater (/discovery, /docs, /specs/*) trenger ingen token.

For å få en token: Logg inn med GitHub over, eller kontakt salg@placepoint.no for høyere tier.

Pris

Hvert kall har en vekt. De fleste oppslag er vekt 1; premium-ruter koster mer — /person/* er vekt 4 (DPA-gated, ikke i self-serve) og POST /ai/recommend er vekt 3. Hvert svar inkluderer:

x-call-weight: 1
x-billing-period-used: 4823
x-billing-period-calls: 1942
x-billing-period-start: 2026-04-01T00:00:00.000Z

Hent full oversikt — kall, vekt, svar-bytes, feilrate, per-produkt, per-dag — på GET /usage (din egen JWT, ingen admin nødvendig).

Referanse

Endepunkt-referansen i sidebar-en til venstre er generert fra data.placepoint.no/docs/json — men generert ved bygg, ikke ved lasting. Den er altså et øyeblikksbilde: regenereres hver gang API-flaten endrer seg (npm run regen i docs-repoet). Sist regenerert 2026-09-02 mot 192 operasjoner.

Er du i tvil om referansen henger etter: /docs er Swagger UI rett på gatewayen og er alltid live.

/person/* er bevisst utelatt fra referansen (databehandleravtale, se over) — de fem rutene finnes i /docs/json, men ikke som sider her.

For LLM/agent-bruk, pek klienten din mot /discovery — den returnerer katalogen, scope-filtrert av din token, med ai_context_url-lenker per produkt.