Adverteren op Trovit Nederland

Woningen Feed

Als je website rubrieksadvertenties van woningen bevat kan je je advertenties heel simpel op Trovit plaatsen:

  1. Schrijf een XML bestand in UTF-8 en Trovit formaat. De specificaties van het Trovit formaat worden hieronder toegelicht.
  2. Stuur ons de link van je XML feed (Bijvoorbeeld: http://www.jedomein.nl/wp_feed.xml) via ons contact e-mail.

Wij zullen je XML feed zo snel mogelijk in ons systeem opnemen en je advertenties op Trovit tonen.

Trovit is een rubrieksadvertentie zoekmachine voor woningen. Wij plaatsen geen advertenties van (bouw)terreinen, kavels, parkeerplaatsen, garages, winkelpanden, kantoorpanden, recreatie- / vakantiewoningen etc.

Jullie feed zal vanaf dit moment dagelijks worden afgelezen om de nieuwste advertenties toe te voegen, de laatste veranderingen toe te passen en de verlopen advertenties te verwijderen als deze niet meer in je feed staan.

Neem gerust contact met ons op als je nog vragen hebt.

XML Woningen Feed Specificaties

Hieronder vind je de richtlijnen voor het aanmaken van een XML woningen feed in Trovit formaat. Voor meer informatie over XML verwijzen we je naar Wikipedia.

De XML feed dient geschreven en opgeslagen te worden in UTF-8 en heeft één ‘Trovit’ tag en één of meer ‘ad’ (advertentie) elementen. Ieder van deze ‘ad’ elementen bevat de volgende velden:

VERPLICHTE VELDEN

  • id: id van de advertentie op je website, deze kan zowel numeriek als alfanumeriek zijn. Belangrijk is dat de id uniek is omdat wij deze gebruiken om dubbele advertenties te voorkomen.
  • url: URL die linkt naar de advertentie op je website
  • title: titel van de advertentie (het moet geheel gerelateerd zijn aan de advertentie, en mag de naam of URL van jouw website niet bevatten).
  • type: soort advertentie; kies het geschikte type:
    • “for rent”: huurwoning
    • “for sale”: koopwoning
    • “roommate”: huisgenoot/kamer te huur
  • content: beschrijving van de woning met minimaal 30 tekens. Hoe meer informatie je ons verschaft, hoe beter de kwaliteit van je advertentie. Wij tonen alleen de delen van de beschrijving die relevant zijn bij een zoekopdracht.

OPTIONELE VELDEN

Mochten jullie over de volgende velden beschikken op jullie website, dan raden wij je aan om deze toe te voegen aan de feed. Als jullie echter deze velden niet hebben, voeg ze dan vooral niet toe. Het algoritme van Trovit rangschikt de advertentie op volgorde van kwaliteit. De meer velden de advertentie bevat de hoger de kwaliteit en de hoger de advertentie in de zoekresultaten zal komen!

  • mobile_url: URL van de advertentie op je website wanneer de gebruiker zijn smartphone gebruikt. (Handig wanneer je website toegankelijk is op dit type toestel).
  • property_type: soort woning; appartement, studio, flat, eengezinswoning, 2-onder-1 kapwoning, tussenwoning, bovenwoning, benedenwoning, hoekwoning, bungalow, boerderij, penthouse
  • agency: naam van het agentschap. Voor meer informatie zie by_owner.
  • price: prijs van de kamer, huurwoning of koopwoning. De prijs van een huurwoning of een kamer zal standaard maandelijks zijn maar jullie kunnen de periode (monthly, daily of weekly) van de huurprijs in deze tag aangeven.
    <price period="weekly"><![CDATA[...]]></price>

    Staan je advertenties in een andere valuta? Trovit zet de prijs automatisch om in euro’s maar daarvoor moet je de correcte ‘currency’ gebruiken. De waardes zijn vastgesteld door de norm ISO-4217.

    Hieronder vind je een voorbeeld van een formaat :

    <price period="weekly" currency="USD"><![CDATA[...]]></price>

    Dit voorbeeld geeft de prijs van een weekelijkse huur in dollars. Je hoeft dus niet het symbool van de valuta naast de prijs aan te geven.

  • floor_area: oppervlakte van de woning in vierkante meters (specifieer: unit=”meters”; geheel getal). Als de advertentie een ander meeteenheid heeft dan de vierkante meter dan mag je je veld met het volgende formaat vullen :
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    De aanvaarde meeteenheden zijn: “meters” of “feet”.

  • rooms: aantal kamers
  • bathrooms: aantal badkamers
  • parking: eigen parkeergelegenheid
  • address: adres
  • city: stad
  • city_area: stadsdeel / wijk
  • postcode: postcode
  • region: provincie
  • latitude: geografische breedte waar de woning zich bevindt. Voor meer informatie zie technische specificaties.
  • longitude: geografische lengte waar de woning zich bevindt. Voor meer informatie zie technische specificaties.
  • virtual_tour: links naar een virtuele tour van de woning
  • eco_score : tekstuele informatie over de energie-efficiëntie van de woning.
  • date: publicatiedatum van de advertentie. Geldige formaten: DD/MM/JJJJ of DD/MM/JJJJ UU:MM:SS en JJJJ/MM/DD of JJJJ/MM/DD UU:MM:SS.
  • expiration_date: datum waarop de advertentie verloopt. Geldige formaten: DD/MM/JJJJ of DD/MM/JJJJ UU:MM:SS en JJJJ/MM/DD of JJJJ/MM/DD UU:MM:SS.
  • plot_area: oppervlakte van het terrein waarop de woning ligt (geheel getal). Als de advertentie een ander meeteenheid heeft dan de vierkante meter dan mag je je veld met het volgende formaat vullen :
    <plot_area unit="hectares"><![CDATA[...]]></plot_area>

    De aanvaarde meeteenheden zijn: “meters”, “feet”, “acres” of “hectares”.

  • floor_number: verdieping van de woning
  • orientation: ligging van de woning; Noord, Zuid, Oost of West
  • mls_database: Uniek ID toegewijst aan elke woning op basis van een MLS (Multiple Listing Service) database.
  • is_furnished: of de woning gemeubileerd is
  • is_new: of de woning nieuw is
  • condition: conditie van de woning, bijvoorbeeld ‘gereformeerd’
  • year: bouwjaar, in het formaat JJJJ
  • by_owner: Wanneer de woning door particulier wordt aangeboden. Dit veld hoeft niet te worden toegevoegd wanneer de woning via een makelaar wordt aangeboden.
  • is_rent_to_own: als de woning te huur is met optie tot koop of niet.
  • pictures: het veld ‘pictures’ (foto’s) bevat alle foto’s van de woning.
    De tag die de foto definieert is <picture>:

    • picture: Deze tag bevat al de velden voor de URL en de titel van de foto (optioneel). Het is mogelijk aan te geven of de foto de hoofdfoto is met het veld ‘featured’.
       
              <picturefeatured="true"><![CDATA[...]]></picture>

      De beschikbare waarden van ‘featured’ zijn: “true” of “false”.

      De velden dat men in de tag <picture> moet aangeven zijn:

      • picture_url: URL van de foto.
      • picture_title: Titel van de foto.
     
    <pictures> 
        <picture> 
            <picture_url><![CDATA[...]]></picture_url> 
            <picture_title><![CDATA[...]]>/picture_title> 
        </picture> 
    
        <picturefeatured="true"> 
            <picture_url><![CDATA[...]]></picture_url> 
            <picture_title><![CDATA[...]]>/picture_title> 
        </picture> 
            ... 
    </pictures>

    De foto die bij de advertentie wordt getoond is de eerste in de fotoreeks van de advertentie.
    Kies daarom de meest relevante foto, aangezien dit veel invloed heeft op het verkeer dat de advertentie zal genereren.

    Trovit staat geen foto’s toe met een logo of de melding ‘Geen foto beschikbaar’.
    Trovit behoudt zich het recht voor om je advertenties te blokkeren.

    Zodra de advertenties zijn opgenomen in ons systeem, is het niet meer mogelijk om de weergegeven foto te veranderen, zelfs niet in de eerstvolgende keer dat de feed wordt afgelezen.
    Wees er daarom zeker van dat alle nieuwe advertenties de correcte foto’s bevatten. De afbeeldingen moeten minstens een grootte hebben van 186x186px met een maximum  van 1 MB.

  • De XML woningen feed in Trovit formaat zou er als volgt uit moeten zien:
    <?xml version="1.0" encoding="utf-8"?>
    <trovit>
    
    <ad>      
        <id><![CDATA[...]]></id>
        <url><![CDATA[...]]></url>
        <title><![CDATA[...]]></title>
        <type><![CDATA[...]]></type>
        <agency><![CDATA[...]]></agency>
        <content><![CDATA[...]]></content>   
        <price><![CDATA[...]]></price>
        <property_type><![CDATA[...]]></property_type>
        <floor_area unit="meters"><![CDATA[...]]></floor_area>
        <rooms><![CDATA[...]]></rooms>
        <bathrooms><![CDATA[...]]></bathrooms>
        <parking><![CDATA[...]]></parking>     
        <address><![CDATA[...]]></address>
        <city><![CDATA[...]]></city>
        <city_area><![CDATA[...]]></city_area>
        <postcode><![CDATA[...]]></postcode>
        <region><![CDATA[...]]></region>  
        <latitude><![CDATA[...]]></latitude>
        <longitude><![CDATA[...]]></longitude>
        <pictures>
            <picture>
                <picture_url><![CDATA[...]]></picture_url>
                <picture_title><![CDATA[...]]></picture_title>
            </picture>
            <picture>
                <picture_url><![CDATA[...]]></picture_url>
                <picture_title><![CDATA[...]]></picture_title>
            </picture>
            ...        
        </pictures>
        <virtual_tour><![CDATA[...]]></virtual_tour>  
        <date><![CDATA[...]]></date>
        <expiration_date><![CDATA[...]]></expiration_date>
        <plot_area><![CDATA[...]]></plot_area>
        <floor_number><![CDATA[...]]></floor_number>
        <orientation><![CDATA[...]]></orientation>
        <is_furnished><![CDATA[...]]></is_furnished>
        <is_new><![CDATA[...]]></is_new>
        <condition><![CDATA[...]]></s_condition>
        <year><![CDATA[...]]></year>
        <by_owner><![CDATA[...]]></by_owner>
    </ad>
    
    <ad>
        ....
    </ad>
    
    <ad>
        ....
    </ad>
    
    ...
    
    </trovit>

    Voorbeeld XML Woningen Feed in Trovit Formaat

    <?xml version="1.0" encoding="utf-8"?>
    <trovit>
    <ad>
    	<id><![CDATA[7004578]]></id>
    	<url><![CDATA[http://wwww.huistekoopoftehuur.nl/ad/7004578]]></url>
    	<title><![CDATA[4 kamer Eengezinswoning in centrum van Maastricht]]></title>
    	<type><![CDATA[For rent]]></type>
    	<agency><![CDATA[Limburg huizenverhuurder]]></agency>
    	<content><![CDATA[Grote 4 kamer eengezinswoning van 3 verdiepingen in kinderrijke
     buurt gelegen aan het water. Eigen parkeergelegenheid, winkelcentrum en openbaar vervoer op 
    loopafstand.]]></content>
    	<price><![CDATA[1100]]></price>
    	<property_type><![CDATA[eengezinswoning]]></property_type>
    	<floor_area unit="meters"><![CDATA[300]]></floor_area>
    	<rooms><![CDATA[4]]></rooms>
    	<bathrooms><![CDATA[1]]></bathrooms>
    	<parking><![CDATA[1]]></parking>
    	<address><![CDATA[Hoge Barakken 1]]></address>
    	<city><![CDATA[Maastricht]]></city>
    	<city_area><![CDATA[Centrum]]></city_area>
    	<postcode><![CDATA[6221 AA]]></postcode>
    	<region><![CDATA[Limburg]]></region>
    	<latitude><![CDATA[50.847095]]></latitude>
    	<longitude><![CDATA[5.702173]]></longitude>
    	<pictures>
    		<picture>
    			<picture_url><![CDATA[http://www.huistekoopoftehuur.nl/foto768.jpg]]
    ></picture_url>
    			<picture_title><![CDATA[woonkamer met uitzicht op tuin]]
    ></picture_title>
    		</picture>
    	</pictures>
    	<date><![CDATA[14/09/2009]]></date>
            <expiration_date><![CDATA[31/12/2009]]></expiration_date>
    	<plot_area><![CDATA[500]]></plot_area>
    	<floor_number><![CDATA[3]]></floor_number>
    	<orientation><![CDATA[Noord-Oost]]></orientation>
    	<is_furnished><![CDATA[0]]></is_furnished>
    	<is_new><![CDATA[0]]></is_new>
    	<condition><![CDATA[recent gereformeerd, met dubbele beglazing en nieuwe 
    CV installatie]]></s_condition>
    	<year><![CDATA[1973]]></year>
            <by_owner><![CDATA[1]]></by_owner>
    </ad>
    <ad>
    	<id><![CDATA[332A53BC2]]></id>
    	<url><![CDATA[http://www.huistekoopoftehuur.nl/ad/332A53BC2]]></url>
    	<title><![CDATA[Studio van 35m² in Utrecht - Kanaleneiland]]></title>
    	<type><![CDATA[For sale]]></type>
    	<content><![CDATA[Nieuw opgeleverde studio, met alle inbouwapparatur gelegen op 5e 
    verdieping van appartementencomplex met lift te huur. Eigen balkon van 5m² op het Westen.]]
    ></content>
    	<price><![CDATA[209950]]></price>
            <property_type><![CDATA[Studio]]></property_type>
    	<floor_area unit="meters"><![CDATA[35]]></floor_area>
    	<rooms><![CDATA[1]]></rooms>
    	<bathrooms><![CDATA[1]]></bathrooms>
    	<parking><![CDATA[0]]></parking>
    	<address><![CDATA[Hammarskjoldhof 100]]></address>
    	<city><![CDATA[Utrecht]]></city>
            <city_area><![CDATA[Kanaleneiland]]></city_area>
    	<postcode><![CDATA[3527 XY]]></postcode>
    	<region><![CDATA[Utrecht]]></region>
            <latitude><![CDATA[52.074117]]></latitude>
    	<longitude><![CDATA[5.094625]]></longitude>
    	<pictures>
    		<picture>
    			<picture_url><![CDATA[http://www.huistekoopoftehuur.nl/foto325.jpg]]
    ></picture_url>
    			<picture_title><![CDATA[badkamer]]></picture_title>
    		</picture>
    	</pictures>
    	<date><![CDATA[14/09/2009]]></date>
    	<expiration_date><![CDATA[30/09/2009]]></expiration_date>
    	<plot_area><![CDATA[35]]></plot_area>
    	<floor_number><![CDATA[1]]></floor_number>
    	<orientation><![CDATA[Westelijk]]></orientation>
    	<is_furnished><![CDATA[0]]></is_furnished>
    	<is_new><![CDATA[1]]></is_new>
    	<condition><![CDATA[nieuwbouw, met inbouwapparatuur]]></condition>
    	<year><![CDATA[2009]]></year>
            <by_owner><![CDATA[1]]></by_owner>
    </ad>
    </trovit>

    Technische specificaties

    Klik hier voor meer informatie: zie technische specificaties.

Privacy policy · Legal Notice · Terms and conditions · Cookie policy