Grundviden

API

Danske ejendomsdata som JSON: adresser, boliger til salg og til leje, virksomheder og personer.

Kom i gang uden at spørge os

De tre første endepunkter herunder er åbne. Du behøver ikke en nøgle, en konto eller en aftale for at prøve dem - prøv det her i din terminal nu:

curl "https://grundviden.dk/api/soeg?q=roskildevej+10"

Maskinlæsbar beskrivelse: /api/openapi.json (OpenAPI 3.1).

Nøgler

En nøgle er valgfri. Uden nøgle virker alt som beskrevet her, med lavere grænser. Med nøgle får du højere grænser - en nøgle er ikke en mur foran det der allerede er åbent.

Du laver, navngiver og trækker dine nøgler tilbage selv, inde i Grundviden Erhverv, på pro.grundviden.dk/noegler. Vi udsteder aldrig en nøgle i hånden og står aldrig mellem dig og den. Send den i headeren X-Api-Key - aldrig i adressen, for adresser havner i logfiler.

curl -H "X-Api-Key: gv_..." "https://grundviden.dk/api/boliger?type=villa&side=1"

Nøgler hører til dataservicen. Grundviden Erhverv koster 495 kr om måneden for platformen, og 995 kr om måneden med dataservicen - altså med det, der står på denne side. Se priserne, hvad der er med og handelsbetingelserne.

Grænser

• Uden nøgle: 30 kald pr. 10 sekunder. (Grundvidens egne sider har deres eget, større rum og deler det ikke med dette.)
• Med nøgle: 120 kald pr. 10 sekunder og 50.000 kald i døgnet.

Rammer du en grænse, får du 429 - og svaret siger hvilken grænse det var, hvor meget du har brugt, og hvornår den nulstilles. Du skal ikke gætte.

Hvad vi lover om ændringer

Ukendte parametre bliver ignoreret, ikke afvist: kaldet lykkes, og de navne vi ikke kendte kommer tilbage i feltet "ukendte", så I kan se hvad der blev set bort fra. Vi kan tilføje felter til et svar uden varsel - læs det felt I skal bruge, og se bort fra resten. Vi fjerner ikke et felt og ændrer ikke betydningen af et id uden at sige det. Sideinddeling: bed om side 1, 2, 3 ... og stop når listen er TOM, eller når I har nået "sider". I får aldrig side 1 igen fordi I bad om en side der ikke findes. Hvor dybt I kan bladre er begrænset - det koster os mere jo dybere I går - og "sider" fortæller jer hvor grænsen går for netop jeres kald. Med nøgle er den højere.

Endepunkter

GET /api/soeg

Fritekstsøgning. Tåler ombyttet rækkefølge og manglende komma: "Fjordvænget 7 4700", "4700 Fjordvænget" og "2820" virker alle. Et rent 5-8-cifret tal læses som et CVR-nummer. I en URL skrives et mellemrum som + eller %20, aldrig som et rå mellemrum: /api/soeg?q=Fjordv%C3%A6nget+7+4700.

Parametre: q, u

• url - Sti til siden om trÆffet på grundviden.dk
• tekst - Visningsnavnet, fx "Roskildevej 10, 2000 Frederiksberg"
• type - adresse, omraade, firma, person eller skole
• lat - Breddegrad (WGS84), null for et træf uden punkt
• lon - Længdegrad (WGS84)

GET /api/boliger

Samme filtre som søgesiden på grundviden.dk. Sideinddelt.

Parametre: m, omr, type, ord, maegler, prismin, prismax, kvmmin, kvmmax, afvmin, afvmax, underskoen, renobudget, renomin, renorabat, modelmin, modelmax, solgtfra, solgttil, depmax, acontomax, forudmax, umodel, nedsat, aendrmin, aendrmax, dage, dagemin, dagemax, arealmin, arealmax, vaermin, vaermax, energifra, energitil, energi, byggefra, byggetil, ombyg, etagemin, etagemax, fred, savemin, savemax, badmin, badmax, toiletmin, ombygfra, ombygtil, boligermin, boligermax, varme, sol, altan, elevator, dyr, ahus, aabenthus, ahdage, ahweekend, grundmin, grundmax, zone, grundtype, byggestatus, bygmin, bygmax, bebygmin, bebygmax, hoejdemin, hoejdemax, spaerre, planniveau, fjernvarme, hav, soe, vand, vandnaer, kystmax, klima, stormflod, skybrud, grundvand, erosion, kloak, stoej, ingensvin, jord, ingentank, tank, skolemin, skolemax, loeft, grundvaerdimin, grundvaerdimax, udsatmin, udsatmax, udsataktmin, udsataktmax, profil, kvartermin, kvartermax, almenmin, almenmax, empmin, empmax, tema, standord, sort, side

• antal - Antal træf i alt, ikke kun på denne side
• side - Sidenummeret DU BAD OM - sammenlign med sider for at se om du kom forbi enden
• sider - Antal sider du kan hente. Bed om en side over dette tal og du får en TOM liste
• sidestoerrelse - Antal boliger pr. side
• boliger - Selve rækkerne
• ukendte - Parametre vi ikke kendte - se afsnittet om ukendte parametre

GET /api/virksomheder

Samme filtre som virksomhedssøgningen. Sideinddelt.

Parametre: q, form, stoerrelse, alder, koncern, branche, omr, resultat, vaerdi, regnskab, beskriver, aardaarligt, naevner, ikrise, krise, risiko, ophoerte, roller, tidligere, m, sort, side, kommune, cvr

• antal - Antal træf i alt
• side - Sidenummeret DU BAD OM - sammenlign med sider for at se om du kom forbi enden
• sider - Antal sider du kan hente. Bed om en side over dette tal og du får en TOM liste
• virksomheder - Selve rækkerne - også når m=person
• ukendte - Parametre vi ikke kendte - se afsnittet om ukendte parametre

GET /api/adresse/{slugEllerId}

Adressen, BBR-kernen, den vurdering der er I KRAFT, energimærke, byggeret og modelpris - de samme tal som siden på grundviden.dk viser, med de samme forbehold. Slug fås fra url-feltet i /api/soeg. Et DAWA-adresse-uuid virker også og svarer 301 til adressens slug. Ingen parametre: alt ligger i stien. ET TAL DER ER NULL HAR ALTID EN GRUND VED SIDEN AF SIG. Hvor vi har tallet, men ikke vil stå inde for det, står det som null med en forbehold-tekst der siger hvorfor - det gælder fx forskellen mellem udbudspris og vores vurdering, som vi ikke viser når annoncen dækker mere end én bolig. Et null uden forbehold betyder aldrig "findes ikke".

Parametre:

• adresse - Identitet: slug, id, vej, postnr, kommune og koordinater
• bbr - Boligtype, byggeår, arealer og antal bygninger
• vurdering - Den offentlige vurdering der er i kraft, og om bygningen indgår i den
• energimaerke - Bogstavet, og hvordan vi har knyttet det til adressen
• byggeret - Tilladt etageareal og resten - resten KAN være negativ, og betyder så at der er bygget mere end planen tillader
• modelpris - Vores prisestimat med usikkerhedsbånd, eller null med en grund
• til_salg - Udbuddet lige nu, hvis der er et - udbudsprisen er mæglerens tal og bliver aldrig tilbageholdt
• ukendte - Parametre vi ikke kendte - se afsnittet om ukendte parametre

GET /api/virksomheder/{cvrnr}

Selskabet i dybden: ejere med andele, den BEREGNEDE ultimative ejer, ledelse og revisor med roller og perioder, seneste regnskab, fravalgt revision, branche og bibrancher, kapital og tegningsregel. De samme oplysninger som siden på grundviden.dk viser. CVR-nummeret er 8 cifre og fås fra cvrnr-feltet i /api/virksomheder. Ingen parametre: alt ligger i stien. ET BELØB REJSER ALDRIG UDEN SIN ENHED. Alle beløb er {vaerdi, enhed}. Nogle selskaber aflægger regnskab i en anden valuta end kroner; kan vi ikke sige hvilken, udelader vi tallet med en forbehold-tekst frem for at sende et tal uden enhed. FELTER MARKERET beregnet ER VORES EGNE TAL, ikke selskabets indberetning. Det gælder værdi- og omsætningsestimatet og den ultimative ejer. Bemærk at vaerdiestimat.regnskaber_brugt er et ANTAL årsrapporter (0-3) og ikke et årstal. Personer er ikke selskaber: denne sti svarer kun på 8-cifrede CVR-numre.

Parametre:

• virksomhedsform - Kort og lang selskabsform samt registrets kode
• status - Registerstatus, ophørt-flag, start- og ophørsdato
• adresse - Adresse, kommune og antal produktionsenheder
• branche - Hovedbranche, branchegruppe og bibrancher
• ansatte - Antal, årsværk og interval - MED den måned registret har stemplet dem. shown = tallet siden viser (value, source register|accounts, old, months_older_than_accounts): et registertal på 24 måneder eller ældre end seneste regnskab er gammelt, og et der modsiges af regnskabets eget gennemsnit viser regnskabets
• kapital - Selskabskapital med valuta, tegningsregel og formål
• regnskab - Seneste aflagte regnskab, dets valuta, erklæring og forbehold. going_concern = årsrapporten indeholder en note om fortsat drift (going concern): selve noten, ikke en usikkerhed og ikke et forbehold
• vaerdiestimat - BEREGNET værdibånd med metode - ikke selskabets eget tal. null for et børsnoteret selskab (se listed)
• listed - Børsnoteret selskab: børsen og linket til dens side hos børsen - i stedet for vaerdiestimat. null for alle andre
• listed_holding - Holding, hvis vaerdi for 25 procent eller mere er børsnoterede selskabers modelvaerdi: andelen i procent, om estimatet er tilbageholdt (over 50 procent) og de børsnoterede selskaber med link. null for alle andre
• omsaetningsestimat - BEREGNET omsætningsbånd - ikke selskabets eget tal
• ejere - Registrerede ejere med andel, som interval hvor registret kun oplyser et interval
• ultimative_ejere - BEREGNET: hvem der i sidste ende ejer selskabet, og ad hvor mange veje
• ledelse - Ledelsesorgan og tegningsberettigede med funktion og periode
• revision - Revisor - en leverandør, ikke et medlem af ledelsen
• fuldt_ansvarlige_deltagere - Et I/S har disse i stedet for ejere
• ukendte - Parametre vi ikke kendte - se afsnittet om ukendte parametre

GET /api/pro/eksport - kræver nøgle

Hele den valgte pro_stat-tabel som CSV, samme tal som dashboardet viser. Kræver nøgle ELLER login, og at kontoen har aktivt Erhverv-abonnement. Kun aggregerede celler - aldrig enkeltrækker eller handler. Strammere kaldgrænse end resten: et kald henter en hel tabel.

Parametre: tabel, geo_niveau, geo_kode

• tabel - marked, aktuel, butik eller butik_maaned - standard er aktuel
• geo_niveau - land, kommune eller postnr - udelad for alle niveauer
• geo_kode - Kommunekode eller postnummer - udelad for alle
• (svar) - text/csv med UTF-8 BOM og en header-række; kolonnerne er tabellens

GET /api/pro/{tabel} - kræver nøgle

Samme celler som CSV-eksporten, sideinddelt. Kræver nøgle ELLER login, og at kontoen har aktivt Erhverv-abonnement. Kun aggregerede celler - aldrig enkeltrækker eller handler. Strammere kaldgrænse end resten.

Parametre: geo_niveau, geo_kode, side

• tabel - marked, aktuel, butik eller butik_maaned - står i stien
• antal - Antal rækker i alt, ikke kun på denne side
• side - Sidenummeret DU BAD OM - sammenlign med sider for at se om du kom forbi enden
• sider - Antal sider. Bed om en side over dette tal og du får en TOM liste
• sidestoerrelse - Antal rækker pr. side
• bygget - Datoen tabellen blev bygget, fra første række på siden
• raekker - Selve cellerne, samme kolonnenavne som CSV-headeren
• tilbageholdt - Kun på rækker med tomme celler: kolonnenavn -> grund. "for_faa" = tallet bag cellen er under vores offentliggørelsesgulv, og "taeller" viser hvilket antal der afgjorde det og hvor stort det er. "ingen_maaling" = vi har ingen registrering for den måned. En tom celle UDEN en grund her er tabellens egen betydning, fx geo_kode på landsniveau

Vilkår for brugen

Data kommer fra offentlige registre og fra vores egne beregninger. Skriv hvor tallene kommer fra, hvis du viser dem videre. Vores beregnede tal - prisestimat og lejeafkast - er estimater, ikke vurderinger, og må ikke fremstilles som en vurdering.

Spørgsmål, eller noget du mangler? Skriv til jonas@enwire.dk. Vi svarer på dansk og engelsk.