Top Agents : XML Feed Details

TopAgents suports automatic updates of the properties your estate agency via an XML feed, an example of this can be found here.

The feed consists of four sections: details, a description of your agency and basic contact details; address, the address of your office; service, the services your agency offers; and finally a list of your current properties.

The details section contains the following fields:

• name, the name of you agency
• tag-line, the branch name or a short description of your other services
• logo, the url of your agencies logo, stored on your website
• description, a full description of your agency and the services it offers
• telephone-sales, the number of your sales hot-line, if present
• telephone-lettings, the number of your lettings hot-line, if present
• email, your email address for sales and lettings enquiries
• website, the address of your website
• auto, the address of your XML feed file

The address section contains the following fields:

• house, the your office building's name
• road, the road name
• near-road, the closest major road, if the office is situated off the main roads
• town-district, the town or district of your office
• near-city, the nearest city, or the city in which your office is located
• county, the county containing your office
• postcode, the postcode of your office
• england, the country - eg. England, Scotland, Wales, or Northern Ireland
• zone, the zone - eg. UK

The services section contains the following fields:

• sales-minimum, the lower limit for the properties you sell (£s)
• sales-maximum, the upper limit for the properties you sell (£s)
• lettings-minimum, the lower limit for the properties you let (£s pcm)
• lettings-minimum, the upper limit for the properties you let (£s pcm)
• covers, the postcode area -- this field may be repeated as many times as is necessary to list all the areas you cover

The property sections contains the following fields, and is repeated for each property you want listed:

• description, a short description of the house offered
• picture, the url of an image of the property, stored on your website
• price, the sales price, or...
• let-pcm, the pcm letting price, or...
• let-pw, the per week letting price, or...
• sold, the price of sale for properties already sold
• house, road, near-road, town-district, near-city, county, postcode, country, and zone -- address as above

The XML file is stored on your server, normally this file will connect to whatever database system you use.

Every time a user accesses your agency page on Top Agents this XML feed is queried and the latest results displayed.

An example of such a page is provided here which reads the XML feed here.