Eurolink API import user guide; getting your properties onto your website from Veco
- Elliott
The following document explains how you can get the property data from your Veco by Eurolink software onto your website. It explains exactly how an import of your property data from Veco works and outlines what you need to do to ensure the information on your website is correct. It also contains important information to ensure your property alert emails link correctly to your website (in the FAQs section).
Contents
1.1 - Overview
1.2 - Setting up an import to your website
1.3 - What information does the website use to display my property listings?
1.4 - Media
1.5 - FAQs - including how to setup your property alert emails
1.1 Overview
The Eurolink API Import is one of the fastest methods of transferring property data. Once setup, it will look for changes to your property listings every 15 mins and immediately makes these changes to your website.
It is available to any client on Veco by Eurolink who has access to the API.
It runs 7 days a week, 8am - 8pm. It does not run overnight when estate agent offices are closed and no changes are taking place.
1.2 Setting up an import to your website
If you’re having a new website built by Webdadi, your Project Manager will be in touch to setup your import. If you already have a Webdadi website and want to setup a new import from Veco by Eurolink, please contact your Account Manager.
We will contact Eurolink on your behalf to obtain the relevant API credentials to setup your import.
1.3 What information does the website use to display my property listings?
The following table outlines what information is used on the website, where it is output, and from where in Veco it gets that information.
Please note - although the Veco software itself is customisable and allows you to create new fields and have a bespoke configurations, the website import only downloads the default/core fields of Veco. This guide is also only relevant to the Atom website platform. It is not entirely compatible with older website templates.
Website Option | Where does it display on the website | Field in Veco by Eurolink | Website Option | Veco by Eurolink Drop Down Option |
House Number | Doesn't output on the website specifically. This field is imported purely to help us identify the property in our database for troubleshooting | Address.BuildingNumber Address.BuildingName | NA |
|
Address 1 | Used to output the address on the search results & property details pages | Address.Street | NA |
|
Address 2 | Used to output the address on the search results & property details pages | Address.DependentLocality | NA |
|
City | Used to output the address on the search results & property details pages | Address.PostTown | NA |
|
Country | Used to output the address on the search results & property details pages | UK | NA |
|
Postcode | Used to output the address on the search results & property details pages. Only the first part of the postcode will show | Postcode.Postcode1 + Postcode.Postcode2 | NA |
|
Branchcode | Determines what branch the property is allocated to. This should match an office setup on the website. This branches details will apear on the property details page (editable in VIA) and is where any arrange a viewing email requests are sent for that property. Properties allocated to a branch not setup on the website will not display | trim(Office.ID) | NA |
|
Additional Features |
|
|
|
|
Mark the property as a New Build (1) | Doesn't output specifically, but allows the property to appear in new homes filter searches if required | Property.NewHome is marked as true | NA |
|
Hidden | Field doesn't output on the website specifically, but when ticked it hides the property from appearing on the website |
| NA |
|
hideprice | Field doesn't output on the website specifically, but when ticked it hides the price from appearing on the website | HidePrice is marked as true | NA |
|
importtype | Determines whether the price of the property is per annum, per month or per week. Doesn't ouput on the site specifically per property as the website is set to display a default, but will use this price to convert to the correct amount according to the website default | Property.RentPeriod | NA |
|
Instructed Date | Field doesn't output on the website specifically, but ensures the newest/oldest filter on the website searches functions correctly. It uses this date to define a property's age. If this is blank, it cannot filter properties by those values | Property.InsertDate | NA |
|
Internal Code | Field doesn't output on the website specifically, but ensure the property can always be viewed by using the clients website URL followed by /property/propertyid eg: estateagent.com/property/12345 | WebID | NA |
|
Long Description | Field outputs as the description on the property details page | Property.MarketingDescriptionHTML | NA |
|
Low Price* | Field outputs as the price on the search results and property details page | Property.AmountInt | NA |
|
Main Features | Outputs as the Main Features bullet points on the property details page | Features.Feature1 up to Features.Feature20 | NA |
|
Number Bathrooms | Outputs as a numeric symbol on the search results and property details page | Property.Bathrooms | NA |
|
Number Bedrooms | Outputs as a numeric symbol on the search results and property details page | Property.Bedrooms | NA |
|
Number Receptions | Outputs as a numeric symbol on the search results and property details page | Property.Receptions | NA |
|
Property Type | Outputs on the search results and property details page (house, flat, apartment etc) | Property.PropertyType |
| |
Short Description | Outputs on the list view of the search results page | Property.SummaryDescription | NA |
|
Status | Outputs as the status of the propery (for sale, under offer etc) | Property.Status | For Sale | For Sale |
Under Offer | Under Offer | |||
Sold STC | Sold Subject to Contract (SSTC) | |||
Sold | Sold | |||
To Let | To Let | |||
Let Agreed | Let or Let Agreed | |||
Tenure | Outputs the tenure underneath the main description on the property listings page | Tenure.Tenure | Commonhold | Commonhold |
Freehold | Freehold | |||
Leasehold | Leasehold | |||
Leasehold + Share of freehold | Leasehold + Share of freehold | |||
Share of freehold | Share of freehold | |||
Terms | Outputs near the price of the property (offers in excess, guide price etc). | Property.PriceStatus | Guide | Guide Price |
Fixed Price | Fixed Price | |||
Offers in the region of | Offers in Region Of | |||
Offers in excess | Offers in Excess of | |||
Offers over | Prices From | |||
Null | Null | |||
Video Tour (multi or single) | Outputs as a video symbol on the search results and property details page. When clicked it displays the video(s) | URLs.URL2 | NA |
|
Webdadi Sub Type | Field doesn't output on the website specifically, but essentially markes the property as a sales or lettings property so it appears in the relevant search | webdadi_sub_type | NA |
|
1.4 Media
Ensure you use the recommended file formats as specified by your Veco software to ensure your photographs, floor plans, Brochures and EPCs display correctly on the website. You should consult with Veco to ascertain exactly how/where to upload the relevant media.
*Please note* - if you make an edit to the media of any property after it has first been added to the website, please ensure you either update the media’s filename, or make an edit to another field to ensure the changes are picked up. Eurolink do not provide a last updated time/date stamp on their media, so you need to either change the filename of the media or update another field to ensure the change is picked up on the website.
1.5 FAQs
How do I make changes to the property listings on my website?
Simply update your property information within Veco and those changes will automatically appear on your website within 15 minutes (providing you have addeded/edited the information into the correct field of Veco)
I’ve made a change to a property listing but not displaying on my website even though it has updated on the property portals?
Firstly, ensure you have added/edited the information in the correct field within Veco. Section 1.3 above outlines what fields you should use in Veco to correctly display on your website. If you’re adding information to other fields not listed above, they won’t display on the website.
The website will update every 15 minutes. Unlike the property portals, the changes are not quite made instantly in real time. Changes can take up to 15 minutes, so please check when you added/edited the property. You may just have to wait for the import to run again if it’s been less time then that since you made your edit. However, the maximise time you should ever wait for an update is 15 minutes
Ensure you have allocated the property to an office that is setup on your website. Properties added to Veco that aren’t allocated to an office, or allocated to an office not setup on the website, will not display.
How often does the Veco by Eurolink API Import run & how quickly will any changes be on my website?
The tool runs every 15 mins to look for changes to your property listings data. When it picks up any edits, additions or deletions of properties, these changes are then directly added to the website and there is no additional processing time. You should never be waiting more than 15 minutes for an update to show on your website.
It runs every day between 8am - 8pm. It does not run overnight, as estate agent offices are closed so no changes will be taking place.
Can I customise my import to use different fields?
In short, no. The website uses a specific set of data from Veco that can’t be customised. However, most of the information on the website is factual data such as the address, price, tenure etc which shouldn’t need to be customised.
You need to add the data you want to display online to the relevant fields in Veco as listed in section 1.3.
Having a standard Import setup for all Veco customers allows us to support and maintain your import. It also means your import is constantly updated in line with any legal requirements.
Do I need to do anything to ensure my property alert emails work correctly once my import is setup?
Yes. Veco should ensure your property alert emails are set up to link to your property listings on the website correctly. They will need to generate a URL to the property online in their email templates. Please contact them directly to ensure they have the following setup:
To link to any property on the website, simply enter your website address followed by:
/property/WebID
eg: www.estateagentwebsite/property/1245091
Keywords:
Veco API import, Veco import, Veco by Eurolink import, website upload from Veco, import