Propertio Developers

Tema

XML / JSON / CSV feedovi ​

Feed je link koji portal ili partner periodično preuzima. Propertio ga pravi iz aktivnih oglasa agencije objavljenih na tu vezu, pri svakom preuzimanju (sa kešom do 5 minuta). Link je zaštićen tokenom; nema API ključa.

FeedFormatZa koga
Generički feedJSON, XML, CSVpartneri, sopstvene integracije, agregatori, migracija
4zidazvanični 4zida XMLportal 4zida.rs
Portali na „feed kitu“XML po specifikaciji portalaHalo oglasi, Nekretnine.rs, NadjiDom, Oglasi.rs, Realitica

Vezu (i link sa tokenom) podešava Propertio tim, ili agencija u režimu za programere. U aplikaciji „Proveri vezu“ prikazuje tačan link.

Opšta pravila ​

  • Token je tajna. Ko ima link, vidi sve oglase u feedu. Šaljite ga samo partneru kome je namenjen; ako procuri, u podešavanjima veze se postavlja novi token (stari link prestaje da radi najkasnije za 5 minuta, kada istekne keš).
  • U feedu su samo aktivni oglasi agencije (do 5.000), osim onih koje je agencija ručno skinula sa te veze; veza filijale nosi samo oglase filijale.
  • Feed se kešira do 5 minuta; češće preuzimanje ne donosi novije podatke. Limit je 120 zahteva u minuti po IP.
  • Linkovi slika u feedu važe 30 dana. Portal ih treba preuzeti (kopirati) pri uvozu, a ne prikazivati direktno.
  • Pogrešan token: 403 sa {"error":"forbidden"} (4zida feed po id-u veze za nepostojeću vezu vraća 404).

Generički feed ​

https://app.propertio.rs/api/plugins/generic-feed/feed/{channelId}.json?token={token}
https://app.propertio.rs/api/plugins/generic-feed/feed/{channelId}.xml?token={token}
https://app.propertio.rs/api/plugins/generic-feed/feed/{channelId}.csv?token={token}

Ista lista oglasa u tri formata. Opcija veze „sakrij adresu“ (hideAddress) uklanja ulicu, broj i koordinate.

JSON ​

json
{
  "generatedAt": "2026-10-20T10:00:00.000Z",
  "count": 1,
  "items": [
    {
      "id": "5b1f0c7e-…", "reference": "P-1042", "title": "Trosoban stan, Vračar", "description": "…",
      "type": "apartment", "deal": "sale", "status": "active",
      "price": 245000, "currency": "EUR", "pricePerSqm": 3500, "areaSqm": 70, "landAreaSqm": null,
      "rooms": 3, "bedrooms": 2, "bathrooms": 1, "floor": 2, "totalFloors": 5, "yearBuilt": 1972,
      "heating": "central", "furnished": "semi", "features": ["Lift", "Terasa"],
      "country": "RS", "city": "Beograd", "municipality": "Vračar", "neighborhood": "Crveni krst",
      "street": "Maksima Gorkog", "streetNumber": "12", "postalCode": "11000", "lat": 44.7953, "lng": 20.4781,
      "images": ["https://app.propertio.rs/media/…/large.webp?md5=…&expires=…"],
      "updatedAt": "2026-10-18T14:21:00.000Z", "publishedAt": "2026-10-01T09:30:00.000Z"
    }
  ]
}

Polje deal je sale ili rent (u API-ju se zove dealType). images su linkovi varijante large (1600 px), naslovna prva. Ostala polja imaju isto značenje kao u modelu oglasa.

XML ​

xml
<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <listing>
    <id>5b1f0c7e-…</id>
    <reference>P-1042</reference>
    <title>Trosoban stan, Vračar</title>
    <type>apartment</type>
    <deal>sale</deal>
    <price>245000</price>
    <currency>EUR</currency>
    <areaSqm>70</areaSqm>
    <city>Beograd</city>
    <features>
      <feature>Lift</feature>
      <feature>Terasa</feature>
    </features>
    <images>
      <image>https://app.propertio.rs/media/…</image>
    </images>
    <updatedAt>2026-10-18T14:21:00.000Z</updatedAt>
    <!-- … ostala polja kao u JSON-u -->
  </listing>
</listings>

CSV ​

Zarezom odvojeno, UTF-8, prvi red je zaglavlje:

reference,title,type,deal,status,price,currency,areaSqm,rooms,floor,yearBuilt,city,municipality,street,streetNumber,lat,lng,features,images,description,updatedAt

Liste (features, images) su spojene znakom |. Vrednosti sa zarezom, tačka-zarezom, navodnicima ili prelomom reda su u navodnicima.

Uvoz iz feeda ​

Ista veza može i da uveze oglase iz vašeg JSON, XML ili CSV feeda (npr. pri prelasku sa drugog softvera), ako je u istim poljima (items / listings.listing / CSV zaglavlje). Oglasi se prepoznaju po reference (ili id), slike se preuzimaju sa linkova iz images. Za uvoz se javite Propertio timu.

4zida ​

4zida.rs preuzima XML agencije svakih 30 minuta, u zvaničnom 4zida formatu (specifikacija). Link koji se šalje 4zidi je trajan i čitljiv:

https://app.propertio.rs/xml/4zida/{feedSlug}.xml?token={token}
  • feedSlug je slug agencije u trenutku povezivanja (npr. agencija-primer, ili agencija-primer-2 ako je zauzet). Ne menja se kada agencija promeni naziv, pa link kod 4zide ostaje ispravan.
  • Token određuje vezu; pogrešan token daje 403.
  • Isti feed je dostupan i po id-u veze: https://app.propertio.rs/api/plugins/4zida/feed/{channelId}.xml?token={token}.

Oglasi koje bi 4zida odbila (nema strukture, ulice, fotografija, nepoznato mesto, cena nije u evrima) ne ulaze u feed; „Proveri vezu“ u aplikaciji ih nabraja sa razlogom. Mesto (<kraj>) se određuje iz grada, opštine i naselja oglasa po šifrarniku 4zide. Opcija veze „sakrij adresu“ šalje sakrivena_adresa.

Postupak kod 4zide: agencija dogovori paket sa prodajom 4zide, pa pošalje link i naziv softvera („Propertio“); 4zida ga poveže. Test okruženje ne postoji: proverite link spolja (otvorite ga u browseru) i počnite sa jednim oglasom. Odbijene oglase 4zida javlja emailom jednom dnevno.

Ostali portali ​

Portali koji preuzimaju XML (Halo oglasi, Nekretnine.rs, NadjiDom, Oglasi.rs, Realitica) imaju isti oblik linka:

https://app.propertio.rs/api/plugins/{portal}/feed/{channelId}.xml?token={token}

gde je {portal} jedno od halooglasi, nekretnine-rs, nadjidom, oglasi-rs, realitica. Nazivi elemenata i šifre vrste i tipa ponude prate specifikaciju portala i mogu se podesiti po vezi kada portal pošalje svoju verziju specifikacije. Ako ste portal ili partner i treba vam feed u vašem formatu, pišite na info@propertio.rs.

Feed ili API? ​

PotrebaRešenje
Portal koji sam preuzima oglase po rasporedufeed
Sajt agencije sa pretragom i stranicama oglasajavni API / SDK
Obaveštenje odmah posle izmenewebhook (+ API ili sopstvena kopija)
Jednokratni izvoz ili tabelaCSV feed