Solgt.no har et REST API som gir verdiestimat og leieestimat for norske boliger. Systemet ditt sender boligens matrikkeldetaljer, eller org.nr og andelsnummer for en borettslagsbolig, til solgtapis.no og får estimatet tilbake som JSON. Hvert kall autentiseres med en nøkkel i headeren X-API-KEY.
API-et dekker over 2,5 millioner eiendommer, og verdi og leie er to av kategoriene på API-siden.
Hvilke endepunkter gir verdi og leie?
| Endepunkt | Svar |
|---|---|
POST /v1/valuation/property | Oppdatert verdiestimat for boligen |
POST /v1/valuation/property/safe_value | Estimert markedsverdi med risikojustering, inkludert fellesgjeld |
POST /v1/valuation/property/comparables | Sammenlignbare salg for boligen |
POST /v1/rental/property | Estimert månedlig leie for boligen |
POST /v1/rental/comps/property | Sammenlignbare utleieobjekter |
GET /v1/rental/listing/{id} | Estimert leie for en annonse, slått opp på ID |
Leieestimater har åtte endepunkter i alt. De fem som mangler i tabellen, står i spesifikasjonen.
Vis gjerne de sammenlignbare salgene ved siden av estimatet i systemet ditt. Da kan saksbehandleren eller kunden kontrollere tallet mot konkrete salg før det brukes videre.
Hvordan peker du ut boligen?
Spesifikasjonen tar matrikkeldetaljene knr, gnr, bnr, fnr og snr, altså kommunenummer, gårdsnummer, bruksnummer, festenummer og seksjonsnummer. For en borettslagsbolig sender du i stedet borettslagets orgnr sammen med andelnr. Det gjelder både verdiestimatet og leieestimatet for en bolig, så samme identifikasjon holder for begge. Annonseoppslaget er unntaket, der står annonsens ID i stien.
Begge formene kan få med valgfrie Custom Overrides når du kaller POST /v1/valuation/property. Med dem legger du inn egne datapunkter om boligen, og estimatet justeres etter dem. Har megleren eller banken bedre opplysninger enn registrene, sender du dem i feltene BRA-i, bedrooms, kitchen_standard og bathroom_standard, og da må alle fire være med. Standardfeltene for kjøkken og bad tar low, medium eller high. safe_value tar ingen overstyringer.
Har brukeren bare skrevet inn en adresse, slår GET /v1/search/query/{query} opp enhetene på den. Søket er gratis, uten sporing og laget for autofullføring. Som alle andre kall mot solgtapis.no krever også det X-API-KEY:
curl -H "X-API-KEY: <DIN_NØKKEL>" \
"https://solgtapis.no/v1/search/query/Storgata%201%20Oslo"Hva ligger bak tallene?
Verdiestimatet fra Solgt.no er en maskinlæringsmodell som kombinerer historiske salgsdata, markedstrender og boligens egenskaper. Det oppdateres daglig og er justert for standard og beliggenhet. Mengden salgsdata varierer mellom boliger og områder.
Leieestimatet bygger på over 200 000 datapunkter fra utleiemarkedet og regner ut fra sammenlignbare utleiepriser i området. Modellen justerer for beliggenhet, størrelse, standard, etasje og boligtype.
Et estimat er en indikasjon, ikke en formell verdivurdering eller en garanti for salgspris. Mer om metodikken står på metodikksiden.
Hvordan blir verdi og leie til direkteavkastning?
Med verdiestimat og månedlig leie for samme bolig kan systemet regne brutto direkteavkastning selv: årlig leieinntekt delt på estimert boligverdi.
Brutto direkteavkastning må vurderes sammen med kostnader, finansiering og tomgang.
Hva mer kan systemet hente om samme bolig?
POST /v1/properties/property gir grunnleggende eiendomsinformasjon, og POST /v1/properties/property/detailed legger til salgs- og overdragelseshistorikk. Et tredje oppslag i kategorien finner nærliggende salg. Med POST /v1/conveyances får du alle registrerte overdragelser for eiendommen, arv og tvangssalg medregnet.
Pant ligger i en egen kategori. POST /v1/encumbrances/mortgages henter registrerte pantedokumenter, og samme kategori har tvangsforretninger og utlegg. Hvem som eier en bestemt enhet, slår du opp med POST /v1/ownersearch/unit, og POST /v1/saleslistings gir alle salgsannonser for eiendommen.
For analyser på områdenivå gir POST /v1/transactions/search solgte boliger over hele landet, nyeste først, og søket kan avgrenses til én kommune eller ett fylke. Utbyggere henter alle tomter i en kommune med POST /v1/plots/municipality.
Hvordan får du nøkkel, og hva koster det?
Du får en unik X-API-KEY ved å kontakte oss.
Kallene er vanlig REST med JSON. OpenAPI-spesifikasjonen ligger på https://solgtapis.no/api-json og som YAML på https://solgtapis.no/api-yaml, klar for automatisk klientgenerering. Dokumentet følger OpenAPI 3.0.0 med tittelen «Solgt.no API» og finnes også på https://solgtapis.no/docs-json. Den samme dokumentasjonen kan leses i nettleseren på https://solgtapis.no/api, der vi også lenker til et API Dashboard med en enkel oversikt over forespørslene dine.
API-et er en egen avtale ved siden av abonnementene, Solgt Max og Solgt MCP medregnet, og prises separat etter avtale og forbruk. Trenger virksomheten mer enn API-et, er Solgt Bedrift vår tilpassede avtale om team, volum, datauttrekk og integrasjoner.
Solgt MCP på mcp.solgt.no bruker en egen Bearer-nøkkel, adskilt fra X-API-KEY. Hvilken av de to som passer jobben din, står i Solgt MCP eller Solgt API.
Nøkkel og avtale for API-et ber du om på kontaktsiden for bedrift.