Extraction of predefined values for use in xml files

Some tags in the different xml files have predefined values.

The URL's must NOT be implemented directly into realtime dynamic systems (creating adverts live and fetching the values directly). They are ment for downloading the values locally and letting be values be fetched from your own system.

 

Access these values through the following URL and adjust with different parameters.

 

Example for estate development project xml:

https://www.finn.no/finn/referencevalue?adType=PROJECTDATA&xmlCode=PROJECT_PREFERENCE

 

Example for Realestate xml: 

https://www.finn.no/finn/referencevalue?adType=ESTATE_SALE&xmlCode=ESTATE_PREFERENCE

The list contains attributes for all ad types within real estate. Which atributes are permitted will differ from ad type to ad type (i.e. Fritidsbolig til salgs and Bolig til salgs).

 

The full overview of ad types and corresponding property types.

view document

 

 


Example for car xml:


https://www.finn.no/finn/referencevalue?adType=CAR&xmlCode=CAR_MODEL/MAKE


https://www.finn.no/finn/referencevalue?adType=CAR&xmlCode=CAR_MODEL/MODEL&parentValueId=3233

 

Example for threshing machine xml:

https://www.finn.no/finn/referencevalue?adType=THRESHING_MACHINE&xmlCode=AGRI_THRESHING_MODEL/MAKE

 

Example for job xml:

New URL for fetching predefined values for Job ads

The FINN.no system for letting users and external Job systems fetch predefined values for some of the fields in the XML (such as DURATION, OCCUPATION and INDUSTRY) was old and outdated.  

Example of the old URL is https://www.finn.no/finn/referencevalue?adType=JOB&xmlCode=DURATION

 

We have made a new URL for this : https://www.finn.no/job/v1/referencevalue

 

An example for DURATION values would look like this : 

 https://www.finn.no/job/v1/referencevalue?xmlCode=DURATION 

 

The new API has an identical interface, so the clients only need to change the URL in their configuration, but migrating to it will bring lots of opportunities.

 

While maintaining backward compatibility, we are adding one long awaited feature to the API. 

So far clients had to retrieve OCCUPATION/GENERAL and OCCUPATION/SPECIALIZATION values in separate calls. 

By calling the new endpoint with parameter OCCUPATION, they will receive everything together, with specializations nested under the general values.

A more detailed specification of the endpoint is available at: https://www.finn.no/job/v1/referencevalue/documentation

In addition, the new endpoint will soon provide even more job-specific features, such as:

  • JSON format in addition to XML
  • More selectable fields related to FINN products

 

Examples for Torget markedplace

Categories

main

https://www.finn.no/finn/referencevalue?adType=SALESOBJECT&xmlCode=CATEGORY/MAINCATEGORY

sub

https://www.finn.no/finn/referencevalue?adType=SALESOBJECT&xmlCode=CATEGORY/SUBCATEGORY

third level

https://www.finn.no/finn/referencevalue?adType=SALESOBJECT&xmlCode=CATEGORY/PRODUCTCATEGORY 

 

What  HTML codes we allow and where they can be used 

https://www.finn.no/api/doc/html-fields 

 

 


Var denne artikkelen nyttig?
0 av 0 syntes dette var nyttig

Trenger du fortsatt hjelp? Kontakt oss her.