Databerigelse med BBR, CVR og vurdering
Har I en liste over kunder, lejemål eller ejendomme? Hver adresse bliver til et BFE-nummer, og det åbner bygningen i BBR, grunden i Matriklen og den offentlige vurdering — og CVR, hvor rækken er en virksomhed. Én nøgle til det hele.
Kundeliste → ejendomsdata
| Adresse | Bygning | Opført | Vurdering |
|---|---|---|---|
solbakkevej 70 silkeborg vasker | |||
nyhavn 20, kbh k vasker | |||
Rådhuspladsen 1, 1550 København V vasker | |||
aaboulevarden 1 aarhus vasker |
/v1/datavask/adgangsadresser, /v1/bbr/ejendom/:bfe og /v1/vurdering/:bfe — og vask og BBR tager 50 ad gangen fra Pro.Kolonnerne
Det, hver række kan få med
Kolonnerne herunder kommer fra hver sit register, men nøglen er den samme: BFE-nummeret fra datavasken. Feltnavnene er API’ets egne.
| Kolonne | Felt i svaret | Register |
|---|---|---|
| BFE-nummer | resultater[ | Datavask (DAR) |
| Opførelses- og om-/tilbygningsår | bygninger[ | BBR |
| Anvendelse | bygninger[ | BBR |
| Bolig- og erhvervsareal | bygninger[ | BBR |
| Tag, ydervæg og varme | bygninger[ | BBR |
| Matrikelnummer, ejerlav og grundareal | jordstykker[ | Matriklen |
| Ejendoms- og grundværdi | seneste. | Vurdering |
| Kommune og region | dagi. | DAGI |
| Virksomhed, branche og status | virksomhed. | CVR |
Opskriften
Tre kald pr. række, i bunker af 50
Vask adresserne, hent bygningerne i BBR og vurderingen pr. BFE. Vask og BBR tager 50 ad gangen fra Pro-planen; på de andre planer er det de samme kald, én række ad gangen.
import csv, requests API = "https://api.grundfast.dk/v1" H = {"Authorization": "Bearer gf_live_…"} def bidder(xs, n=50): for i in range(0, len(xs), n): yield xs[i : i + n] rows = list(csv.DictReader(open("kunder.csv", newline=""))) for bid in bidder(rows): # 1) Vask adresserne → BFE-nummer (ét kald pr. unik adresse) adresser = sorted({r["adresse"].strip() for r in bid if len(r["adresse"].strip()) >= 2}) vask = requests.post(f"{API}/datavask/adgangsadresser:batch", headers=H, json={"betegnelser": adresser}).json() pr_adresse = {v["input"]: v for v in vask["results"]} for row in bid: v = pr_adresse.get(row["adresse"].strip()) row["bfe"] = v["resultater"][0]["bfe_nummer"] if v and v["antal"] else None # 2) BFE → bygningerne i BBR, 50 ejendomme pr. kald bfer = sorted({r["bfe"] for r in bid if r["bfe"]}) ejendomme = {} if bfer: bbr = requests.post(f"{API}/bbr/ejendom:batch", headers=H, json={"bfe": bfer}).json() ejendomme = {e["bfe"]: e["ejendom"] for e in bbr["results"]} for row in bid: e = ejendomme.get(row["bfe"]) i = e["hovedbygning_index"] if e else None hoved = e["bygninger"][i] if i is not None else {} row["opfoert"] = hoved.get("opfoerelsesaar") row["anvendelse"] = (hoved.get("anvendelse") or {}).get("tekst") # 3) BFE → den offentlige vurdering if row["bfe"]: vur = requests.get(f"{API}/vurdering/{row['bfe']}", headers=H).json() row["ejendomsvaerdi"] = (vur.get("seneste") or {}).get("ejendomsvaerdi_kr")
- Pr. række
- 3 kald: vask, BBR og vurdering
- 1.000 rækker
- 3.000 kald
- Free
- ca. 1.666 rækker om måneden
- Starter
- ca. 33.333 rækker om måneden
Et batch-kald tæller én gang pr. række — dubletter kun én gang — så en bunke på 50 koster aldrig mere end 50 enkeltkald. Se alle planer på priser.
Hvem bruger det
Lister, der skal blive til beslutninger
Porteføljer, der skal screenes, boligdata i et produkt og skrivebordsundersøgelser før et besøg. Se hvert job gjort på en rigtig ejendom.
- Investorer, asset managers, rådgivereDue diligenceScreen en ejendom eller en hel portefølje, før I byder
- Produktteams bag bolig-, forsikrings- og mæglerappsProptech og boligplatformeFang adressen rigtigt, og vis hele ejendommen i jeres produkt
- Bygge- og miljørådgivere, geoteknikereMiljø og geoteknikSkrivebordsundersøgelsen før asbest- og PCB-screening, jord og geoteknik
Spørgsmål
Ofte stillede spørgsmål
Datavasken gør adressen rigtig og finder ejendommens BFE-nummer. Databerigelsen bruger BFE-nummeret til at hente det, rækken ikke havde: bygningen fra BBR, grunden fra Matriklen, den offentlige vurdering og — hvor rækken er en virksomhed — CVR.
Opskriften på siden bruger 3 kald pr. række: vask, BBR og vurdering. 1.000 rækker er altså 3.000 kald. Free-planens 5.000 kald rækker til omkring 1.666 rækker om måneden, Starter til 33.333. Batch-kaldene er med fra Pro-planen og koster det samme pr. række.
BBR-svaret har alle bygninger på ejendommen i bygninger[] og peger på hovedbygningen med hovedbygning_index. Vil I have én værdi pr. række, så tag hovedbygningen; vil I have totaler, så læg arealerne sammen over listen.
Nej. Ejerfortegnelsen udstiller vi ikke i dag, så en række får ikke ejerens navn. Er ejeren en virksomhed, og kender I CVR-nummeret, kan I berige med virksomhedens navn, branche og status fra CVR.
Ja, når I har CVR-numrene: /v1/cvr/:cvr giver navn, status, branche og beliggenhedsadresse, og adressen kan vaskes videre til BFE-nummer og ejendom. Opslag sker på CVR-nummer — søgning på virksomhedsnavn er ikke åben.
Svarene kommer fra registrene på Datafordeleren. Er et register nede, svarer vi fra vores seneste kopi og siger det i headeren X-Grundfast-Stale, så I kan vælge at prøve rækken igen senere.
Se også
Databerigelse
Berig de første rækker i dag
Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0