XML feed za agencije: format i povezivanje

Kako povezati feed

• Preuzmite profil agencije u imeniku agencija (prijava adresom na domeni agencije).
• U Mojim oglasima, u kartici agencije, upišite adresu feeda i kliknite „Provjeri feed“. Pokazat ćemo koliko oglasa možemo objaviti i zašto smo neke preskočili.
• Kliknite „Spremi feed“. Spremamo ga samo ako provjera pronađe barem jedan oglas, a prvo čitanje pokrećemo odmah.
• Feed zatim čitamo četiri puta dnevno umjesto Vaše stranice. Ako ga uklonite, ponovno čitamo stranicu.

Format

Jedna XML datoteka u UTF-8, javno dostupna na domeni Vaše agencije (do 20 MB i 2.000 oglasa). Korijenski element je <najamstanova version="1">, a svaki oglas je jedan element <listing>. DOCTYPE i ENTITY deklaracije nisu dopuštene.

Obavezna su dva polja:

• url: poveznica na oglas na Vašoj stranici (na Vašoj domeni). Po njoj prepoznajemo oglas, pa oglas koji smo već imali s Vaše stranice samo osvježimo.
• rent: mjesečna najamnina, s atributom currency="EUR".

Neobavezna polja (što više, to bolje):

• type: apartment ili house
• area: površina u m²; rooms: broj soba (1, 1.5, 2… ili garsonijera); bedrooms: broj spavaćih soba
• floor i floors: kat i ukupan broj katova
• city, neighbourhood i street: grad, kvart i ulica (bez kućnog broja); lat i lng: koordinate
• utilities: included, excluded ili partial (režije uključene, nisu uključene ili djelomično)
• deposit i agency-fee: polog i agencijska naknada, kratkim tekstom (npr. „1 najamnina“, „50 % najamnine“)
• furnished: yes, partly ili no; pets: yes ili no
• available-from: datum useljenja (2026-11-01); energy-class: energetski razred
• features: popis opreme odvojen zarezima (balkon, lift, parking…)
• images: elementi <image> s poveznicama na fotografije (najviše 12)

Primjer

Jedan oglas sa svim poljima:

<?xml version="1.0" encoding="UTF-8"?>
<najamstanova version="1">
  <listing>
    <url>https://vasa-agencija.hr/najam/stan-1024</url>
    <type>apartment</type>
    <rent currency="EUR">750</rent>
    <area>55</area>
    <rooms>2</rooms>
    <bedrooms>1</bedrooms>
    <floor>3</floor>
    <floors>5</floors>
    <city>Zagreb</city>
    <neighbourhood>Trešnjevka</neighbourhood>
    <street>Selska cesta</street>
    <lat>45.8031</lat>
    <lng>15.9542</lng>
    <utilities>excluded</utilities>
    <deposit>1 najamnina</deposit>
    <agency-fee>50 % najamnine</agency-fee>
    <furnished>yes</furnished>
    <pets>no</pets>
    <available-from>2026-11-01</available-from>
    <energy-class>C</energy-class>
    <features>balkon, lift, parking</features>
    <images>
      <image>https://vasa-agencija.hr/slike/1024-1.jpg</image>
      <image>https://vasa-agencija.hr/slike/1024-2.jpg</image>
    </images>
  </listing>
</najamstanova>

Što radimo s feedom

• Oglase provjeravamo istim pravilima kao i sve ostale: samo dugoročni najam stanova i kuća u Zagrebu, s najamninom u eurima.
• Opise ne preuzimamo. Tekst kartice sastavljamo iz činjenica, kao i za oglase s Vaše stranice.
• Fotografije prikazujemo izravno s Vašeg poslužitelja, kao i dosad. Ako u Mojim oglasima dopustite kopiranje, smanjujemo ih, uklanjamo im skrivene podatke i spremamo kod nas; brišemo ih kad oglas nestane iz feeda ili kad dopuštenje povučete.
• Oglas koji nestane iz feeda uklanjamo kod sljedećeg čitanja. Ako feed odjednom ima manje od polovice dotadašnjih oglasa, ništa ne uklanjamo, jer je to najčešće pogreška izvoza.
• Svaki oglas i dalje vodi na Vaš izvorni oglas, a kontakt s najmoprimcem uvijek je na Vašoj stranici.

Pitanja

Ako Vaš CRM ne može izraditi ovaj format ili trebate pomoć, pišite nam s adrese agencije. Odgovaramo na svaki upit.