18.01.2024
The field 'service_documents' has been removed. Use a media element described as 'Tilstandsrapport' for 'Tilstandsrapport', a link marked 'rel="urn:finn:iad:ad:naftest"' for 'NAF Test' and the 'car_service_history' field for 'Servicehistorikk' instead.
18.01.2024
The field 'nbf' has been replaced with 'member_of_nbf'. The field 'member_of_nbf' is a boolean field that will have the value 'true' if the advertiser is a member of NBF (Norges Bilbransjeforbund).
26.11.2019
There has been some confusion causing duplicate information in two fields. To fix this the field "completion" has been removed. You should use "development_completion_date" instead.
19.09.2019
The field "shared_cost_includes" has been added to realestate-project ads. The field is a text field which can contain a description of the shared costs (felleskostnader) for the units in the project.
05.12.2018
Two new fields have been introduced to the Ad model for realestate-homes, realestate-leisure-sale, realestate-plot, realestate-project-unit, realestate-development-single. The new fields are named total_price and sales_cost_sum.
Total_price is a field that will contain the total price, that is the sum of the price suggestion, debt, sales tax and other sales costs.
Sales_cost_sum is a field that will contain the sum of all known sales cost like sales tax, official registrion, printing of documents etc.
Be aware of the old field total. This field must not be confused with the new total_price field. Therefore the old total field has been deprecated and will be removed on all Ad models for realestate (except realestate-development). If needed you can replace 'total' with an other new field 'price_with_collective_debt'. 'price_with_collective_debt' contain the same information as the old total field, but you should of course favor the new total_price field.
For more information about this change see the new guidelines for marketing of residences from The Consumer Authority or this statement from Eiendom Norge
28.09.2018
From 1.10.2018 the ad pages for realestate-homes and realestate-leisure-sale will be displayed in quite a new way when the new fields estate_summary, essential_info and local_area_name will be shown.
In addition there are two new link types where the rel-attribute is "urn:finn:realestate:prospectorder" and "urn:finn:realestate:prospectview".
14.05.2018
Road tax is from 1.1.2018 inclueded in the trafic insurrance. The field road_tax_included is therefore removed from all motor ad types and searches.
24.11.2017
The field wheel_sets has been removed on all motor ads, such as car-used-sale ads. The different types of tires is still included in the field equipment
15.10.2017
If you have any issues connecting to the APIs, please consult <a href="https://letsencrypt.org/docs/" target="_blank" rel="noopener">Let's Encrypt documentation page</a>
12.05.2017
The field regulation on plot ads has been deprecated and will be removed after 12.08.2017. Instead you can use the new field regulations, which is also used on other realestate ad types, and contains the same values as the deprecated field.
01.02.2017
Image URL paths will change slightly as we switch to a new image delivery service. All clients manipulating or replacing URLs need to update to the new structure:
https://images.finncdn.no/mmo/../../..
Image URL paths will not have this segment after 01.04.2017. A redirect to the new URL will be provided for some time.
https://images.finncdn.no/dynamic/default/../../..
Working today, but not provided in any of FINNs APIs until 01.04.2017.
If you are currently replacing /mmo/ with /dynamic/XXX/, you need to look for /mmo/ and/dynamic/default/ and replace both occurencies with /dynamic/XXX/.
13.06.2016
The field member_of_norboat_trade_association has been added to the ad types boat-dock, boat-new-sale, boat-used-wanted, boat-motor and boat-rent.
The field will have the value true if the advertiser is registred in FINN admin as a member of Norboat.
25.04.2016
The field road_tax_included is discontinued for ad types agriculture-tresher, agriculture-tools, agriculture-tractor, bus, construction and truck. Please make sure your clients/parsers do not break when not finding the field.
12.04.2016
The image size 1598w is discontinued and replaced by 1600w. A redirect from 1598w to 1600w will be provided. Please make sure only to use documented image sizes.
01.02.2016
As a part of the move from http to https, we are forcing the the links to images, logos and other FINN pages to use https.
08.04.2015
On the commercial property rent and sale search result (realestate-business-letting, realestate-business-sale), we are removing the size/living number field, and replacing it with a size/main, which is a number range.
07.04.2015
adata-field: "keywords".
13.03.2015
The filter school_cathcment_area on realestate searches (realestate-homes, realestate-letting) is being removed.
13.10.2014
The facet category on job searches (job-full-time, job-management, job-part-time) is being removed. It has been replaced with the new facets occupation and industry
29.08.2014
The ownership_type field on the search result of realestate-leisure-sale and realestate-leisure-sale-abroad previously presented as a list of 1 element. This has now been fixed to be a single field of type "string", matching the model and the datatype on the ad-resource.
Before
<finn:field name="ownership_type"> <finn:value>Andel</finn:value> </finn:field>
After
<finn:field name="ownership_type" value="Andel" />
Also, the following field descriptions (models) have been corrected:
furnished on realestate-letting from Boolean to list of Stringproperty_type on realestate-letting-wanted from enum to list of Stringliving on realestate-business-letting and realestate-business-letting from Number to Rangesize on realestate-development-single (was listed twice in the model)12.08.2014
The image-size resource is a configuration service that allows you manipulate images URLs to get image in alternative physical sizes
See API reference
Please use our Customer Service