Feed API - Documentatie Tehnica

Integrare portaluri imobiliare cu Lukian CRM

v2.0

1. Introducere

Lukian CRM ofera doua metode de integrare pentru portalurile imobiliare:

Push (standard)

Lukian publica automat anunturile pe API-ul portalului (Storia, Imobiliare.ro, Publi24). Noi facem toata munca.

Pull (feed)

Portalul citeste anunturile din feed-ul nostru API. Acest document acopera metoda Pull.

Pentru majoritatea portalurilor partenere, echipa Lukian realizeaza integrarea completa pe baza documentatiei API a portalului. Daca preferati aceasta abordare, contactati-ne.

2. Autentificare

Fiecare portal primeste o cheie API unica de la Lukian. Cheia se transmite ca parametru query:

GET
https://api.lukian.ai/api/v2/portals/homezz/feed.json?api_key=YOUR_KEY
  • Cheile sunt per-portal, nu per-agentie
  • Limita: 120 cereri/ora per cheie API
  • Cache server-side: 5 minute

3. Endpoint-uri

MethodEndpointDescriere
GET/api/v2/portals/{portal}/feed.jsonFeed complet JSON
GET/api/v2/portals/{portal}/feed.xmlFeed complet XML
GET/api/v2/portals/{portal}/feed.json?agency={slug}Feed filtrat per agentie
GET/api/v2/portals/{portal}/statusStatus feed (contor, ultima actualizare)

Toate endpoint-urile necesita parametrul ?api_key=YOUR_KEY

4. Format raspuns JSON

application/json
feed.json
{
  "portal": "homezz",
  "generated_at": "2026-04-06T14:00:00Z",
  "total_agencies": 2,
  "total_properties": 500,
  "agencies": [
    {
      "id": "deximoweb",
      "name": "Deximo Imobiliare",
      "domain": "deximo.ro",
      "logo": "https://api.lukian.ai/cdn/storage/...",
      "phone": "+40724310800",
      "email": "[email protected]",
      "city": "Constanta"
    }
  ],
  "properties": [
    {
      "id": 123,
      "agency_id": "deximoweb",
      "external_id": "REF-123",
      "title": "Apartament 2 camere Tomis Nord",
      "property_type": "apartment",
      "transaction_type": "sale",
      "price": 85000,
      "currency": "EUR",
      "surface": {
        "usable": 52,
        "built": 58,
        "land": null
      },
      "rooms": 2,
      "bedrooms": 1,
      "bathrooms": 1,
      "floor": 3,
      "total_floors": 8,
      "year_built": 2020,
      "location": {
        "city": "Constanta",
        "neighborhood": "Tomis Nord",
        "street": "Str. Exemplu 12",
        "latitude": 44.186,
        "longitude": 28.634
      },
      "description": "Apartament modern, complet mobilat...",
      "features": ["centrala proprie", "balcon", "parcare"],
      "energy_class": "B",
      "heating": "centrala proprie",
      "photos": [
        "https://api.lukian.ai/cdn/storage/photo1.jpg",
        "https://api.lukian.ai/cdn/storage/photo2.jpg"
      ],
      "url": "https://deximo.ro/123-apartament-2-camere-tomis-nord",
      "agent": {
        "name": "Ionel Groze",
        "phone": "+40724000000"
      },
      "created_at": "2026-04-01T10:00:00Z",
      "updated_at": "2026-04-05T14:30:00Z"
    }
  ]
}

5. Format raspuns XML

application/xml
feed.xml
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="https://api.lukian.ai/feed/v2"
      portal="homezz"
      generated="2026-04-06T14:00:00Z">
  <agencies total="2">
    <agency id="deximoweb">
      <name>Deximo Imobiliare</name>
      <domain>deximo.ro</domain>
      <phone>+40724310800</phone>
      <email>[email protected]</email>
      <city>Constanta</city>
    </agency>
  </agencies>
  <properties total="500">
    <property id="123" agency_id="deximoweb">
      <title>Apartament 2 camere Tomis Nord</title>
      <url>https://deximo.ro/123-apartament-2-camere-tomis-nord</url>
      <property_type>Apartament</property_type>
      <transaction_type>Vanzare</transaction_type>
      <price currency="EUR">85000</price>
      <surface>
        <usable>52</usable>
        <built>58</built>
      </surface>
      <rooms>2</rooms>
      <bedrooms>1</bedrooms>
      <bathrooms>1</bathrooms>
      <floor>3</floor>
      <total_floors>8</total_floors>
      <year_built>2020</year_built>
      <location>
        <city>Constanta</city>
        <neighborhood>Tomis Nord</neighborhood>
        <street>Str. Exemplu 12</street>
        <latitude>44.186</latitude>
        <longitude>28.634</longitude>
      </location>
      <description>Apartament modern...</description>
      <features>
        <feature>centrala proprie</feature>
        <feature>balcon</feature>
        <feature>parcare</feature>
      </features>
      <energy_class>B</energy_class>
      <heating>centrala proprie</heating>
      <photos>
        <photo>https://api.lukian.ai/cdn/storage/photo1.jpg</photo>
        <photo>https://api.lukian.ai/cdn/storage/photo2.jpg</photo>
      </photos>
      <agent>
        <name>Ionel Groze</name>
        <phone>+40724000000</phone>
      </agent>
      <created_at>2026-04-01T10:00:00Z</created_at>
      <updated_at>2026-04-05T14:30:00Z</updated_at>
    </property>
  </properties>
</feed>

6. Referinta campuri proprietate

CampTipDescriereExemplu
idintegerID unic proprietate in Lukian1234
agency_idstringSlug-ul agentiei"deximoweb"
external_idstring | nullReferinta externa (optional)"REF-456"
titlestringTitlu complet"Apartament 2 camere Tomis Nord"
property_typestringTip proprietate (vezi tabel mai jos)"apartment"
transaction_typestringTip tranzactie"sale"
pricenumberPretul proprietatii85000
currencystringMoneda (EUR/RON)"EUR"
surface.usablenumber | nullSuprafata utila (mp)52.5
surface.builtnumber | nullSuprafata construita (mp)58
surface.landnumber | nullSuprafata teren (mp, pt case/terenuri)250
roomsinteger | nullNumar camere2
bedroomsinteger | nullNumar dormitoare1
bathroomsinteger | nullNumar bai1
floorinteger | nullEtaj (0 = parter)3
total_floorsinteger | nullEtaje totale cladire8
year_builtinteger | nullAnul constructiei2020
location.citystring | nullOras"Constanta"
location.neighborhoodstring | nullCartier / Zona"Tomis Nord"
location.streetstring | nullStrada (daca e publica)"Str. Exemplu 12"
location.latitudenumber | nullLatitudine GPS44.186
location.longitudenumber | nullLongitudine GPS28.634
descriptionstringDescriere completa HTML"..."
featuresstring[]Lista facilitati["centrala proprie", "balcon"]
energy_classstring | nullClasa energetica (A, B, C...)"B"
heatingstring | nullTip incalzire"centrala proprie"
photosstring[]URL-uri fotografii (ordonate)["https://..."]
urlstringLink proprietate pe site agentie"https://deximo.ro/..."
agent.namestring | nullNumele agentului"Ionel Groze"
agent.phonestring | nullTelefon agent"+40..."
agent.emailstring | nullEmail agent"ionel@..."
created_atstringData adaugarii (ISO 8601)"2026-04-01T10:00:00Z"
updated_atstringUltima actualizare (ISO 8601)"2026-04-05T14:30:00Z"

7. Mapare tipuri proprietati

ValoareDescriere RODescriere EN
apartmentApartamentApartment
houseCasa / VilaHouse / Villa
landTerenLand
commercialSpatiu comercialCommercial space
officeBirouOffice
garageGaraj / ParcareGarage / Parking
studioGarsonieraStudio

8. Mapare tipuri tranzactie

ValoareDescriere
saleVanzare
rentInchiriere

9. Coduri HTTP Status

CodDescriere
200Succes
401API key lipsa sau invalid
404Portal inexistent
429Rate limit depasit (Header: Retry-After)
500Eroare server

10. Rate Limiting

Fiecare raspuns include urmatoarele header-e:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1712412000
  • X-RateLimit-Limit: Limita maxima per ora (120)
  • X-RateLimit-Remaining: Cereri ramase in fereastra curenta
  • X-RateLimit-Reset: Unix timestamp cand se reseteaza fereastra

Daca depasiti limita, veti primi raspuns 429 cu header-ul Retry-After.

11. Notificari Webhook (optional, viitor)

In dezvoltare

In viitor, Lukian va putea trimite notificari webhook cand:

  • O proprietate noua este adaugata
  • O proprietate este actualizata (pret, descriere, fotografii)
  • O proprietate este stearsa / vanduta

Contactati-ne daca doriti sa fiti notificati cand aceasta functionalitate devine disponibila.

12. Exemple curl

# Feed complet JSON
curl "https://api.lukian.ai/api/v2/portals/homezz/feed.json?api_key=YOUR_KEY"
# Feed complet XML
curl "https://api.lukian.ai/api/v2/portals/homezz/feed.xml?api_key=YOUR_KEY"
# Filtrat per agentie
curl "https://api.lukian.ai/api/v2/portals/homezz/feed.json?api_key=YOUR_KEY&agency=deximoweb"
# Status feed
curl "https://api.lukian.ai/api/v2/portals/homezz/status?api_key=YOUR_KEY"

13. Contact & Suport

Email pentru integrari portaluri:

[email protected]

Pentru integrare push (Lukian publica automat pe portalul vostru), ne puteti trimite documentatia API a portalului si realizam integrarea complet de la capat.

Portaluri integrate in prezent prin push: Storia + OLX, Imobiliare.ro, Publi24