Get listings sale plot information
GET/listings/sale/plot
Read Listings Sale Plot Endpoint
Overview
The API endpoint retrieves listings sale plot data based on filters such as property ID NMA, Finn code, batch ID, or a specified date range. The API supports retrieval of single, multiple, or batch property listings.
Example Request
- Listings from a specific date:
curl -X 'GET' \
'https://apis.propcloud.no/api/public/listings/sale/plot?start-date=2025-01-01&batch-id=0' \
-H 'accept: application/json' \
-H 'api-key: YOUR_API_KEY'
Response Description
| Key | Description | Beskrivelse | Source |
|---|---|---|---|
totalPages | The total number of pages of response for this specific query. | Totalt antall sider med respons for denne spesifikke forespørselen. | PropCloud |
batchId | Unique identifier for the batch | Unik identifikator for batchen | PropCloud |
finnCode | This code is used to identify ads in FINN | Kode brukt for a identifisere annonsen | Finn.no |
adtype | The type of listing (e.g., sale, rental). | Type oppforing (f.eks. salg, utleie). | Finn.no |
propertyId | Unique identifier for the property. | Unik identifikator for eiendommen. Feltet heter MatrikkelenhetId i Matrikkelen | Kartverket |
propertyIdNma | Unique identifier for the property, generated based on city number, ground number, and other details. | Unik identifikator for eiendommen generert basert pa kommunenummer, gardsnummer og andre detaljer. | PropCloud |
addressId | Unique identifier for the address of the unit. | Unik identifikator for adressen til enheten. | Kartverket |
unitId | Unique identifier for the unit within the property | Unik identifikator for bruksenheten. Feltet heter BruksenhetId i Matrikkelen | Kartverket |
link | The URL to view more details about the property listing. | Nettadressen til annonsen. | Finn.no, Hjem.no |
heading | Title or headline of the property listing. | Overskrift pa annonsen. | Finn.no |
listingDate | The date when the property was listed or last updated. | Datoen da eiendommen ble lagt ut eller sist oppdatert. | Finn.no |
listingCategory | Category of the listing, such as new builds, used homes, or commercial properties. | Kategori for oppforingen, for eksempel nybygg, bruktbolig eller naeringseiendom | Finn.no |
address | The physical address of the property. | Eiendommens fysiske adresse. | Finn.no, Hjem.no |
cityName | Name of the city | Navn pa kommunen Feltet heter kommunenavn i Matrikkelen | Kartverket |
cityNumber | Unique identifier for the city. | Kommunenummer, unik identifikator for kommunen | Kartverket |
countyName | Name of the county | Navn pa fylket Feltet heter fylkesnavn i Matrikkelen | Kartverket |
countyNumber | Unique identifier for the county. | Fylkesnummer, unik identifikator for fylket | Kartverket |
postalArea | The name of the postal area. | Navn pa postomradet | Kartverket |
postalRegion | city number and postal code separated by "-" | Kommunenummer og postnummer separert med "-" | Kartverket |
postalCode | The postal code where the unit is located. | Postnummeret der bruksenheten ligger | Kartverket |
lat | Latitude coordinate of the unit. | Breddegrad koordinat for enheten. | Kartverket |
lon | Longitude coordinate of the unit. | Lengdegrad koordinat for enheten. | Kartverket |
gnr | The farm number (Gardsnummer). | Gardsnummer (gnr), identifikator for eiendommer i en kommune. | Kartverket |
unr | Usage number (Bruksnummer). | Bruksnummer | Kartverket |
snr | The section number (Seksjonsnummer). | Seksjonsnummer, brukes for seksjonerte eiendommer. | Kartverket |
lnr | Lease number (Festenummer). | Festenummer | Kartverket |
apartmentNumber | The specific unit number, i.e. H0101. | Bruksenhetsnummeret, i.e. H0101. | PropCloud, Kartverket |
propertyType | The type of property, such as residential, commercial, or industrial. | Eiendomstype, som bolig, naeringseiendom eller industri. | Finn.no, Hjem.no |
ownershipForm | Specifies the form of ownership, such as freehold, co-op, or share. | Angir eierskapsformen, som f.eks. selveier, borettslag eller aksje | PropCloud, Kartverket |
parkingSpaces | The number of parking spaces available. | Antall parkeringsplasser tilgjengelig. | |
landArea | The land area of the property. | Tomtearealet til eiendommen. | |
totalPrice | The total price of the property. | Totalprisen pa eiendommen. | |
listingPrice | The listing price of the property. | Prisantydningen pa eiendommen. | |
leaseFee | The fee for leasing the property. | Avgiften for a leie eiendommen. | |
costs | Additional costs associated with the property. | Ekstra kostnader tilknyttet eiendommen. | |
brokerName | The name of the broker handling the property. | Navnet pa megleren som handterer eiendommen. |
Request
Responses
- 200
- 422
Successful Response
Validation Error