Feed API - Documentatie Tehnica
Integrare portaluri imobiliare cu Lukian CRM
1. Introducere
Lukian CRM ofera doua metode de integrare pentru portalurile imobiliare:
Lukian publica automat anunturile pe API-ul portalului (Storia, Imobiliare.ro, Publi24). Noi facem toata munca.
Portalul citeste anunturile din feed-ul nostru API. Acest document acopera metoda Pull.
2. Autentificare
Fiecare portal primeste o cheie API unica de la Lukian. Cheia se transmite ca parametru query:
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
| Method | Endpoint | Descriere |
|---|---|---|
| GET | /api/v2/portals/{portal}/feed.json | Feed complet JSON |
| GET | /api/v2/portals/{portal}/feed.xml | Feed complet XML |
| GET | /api/v2/portals/{portal}/feed.json?agency={slug} | Feed filtrat per agentie |
| GET | /api/v2/portals/{portal}/status | Status feed (contor, ultima actualizare) |
Toate endpoint-urile necesita parametrul ?api_key=YOUR_KEY
4. Format raspuns 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
<?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
| Camp | Tip | Descriere | Exemplu |
|---|---|---|---|
id | integer | ID unic proprietate in Lukian | 1234 |
agency_id | string | Slug-ul agentiei | "deximoweb" |
external_id | string | null | Referinta externa (optional) | "REF-456" |
title | string | Titlu complet | "Apartament 2 camere Tomis Nord" |
property_type | string | Tip proprietate (vezi tabel mai jos) | "apartment" |
transaction_type | string | Tip tranzactie | "sale" |
price | number | Pretul proprietatii | 85000 |
currency | string | Moneda (EUR/RON) | "EUR" |
surface.usable | number | null | Suprafata utila (mp) | 52.5 |
surface.built | number | null | Suprafata construita (mp) | 58 |
surface.land | number | null | Suprafata teren (mp, pt case/terenuri) | 250 |
rooms | integer | null | Numar camere | 2 |
bedrooms | integer | null | Numar dormitoare | 1 |
bathrooms | integer | null | Numar bai | 1 |
floor | integer | null | Etaj (0 = parter) | 3 |
total_floors | integer | null | Etaje totale cladire | 8 |
year_built | integer | null | Anul constructiei | 2020 |
location.city | string | null | Oras | "Constanta" |
location.neighborhood | string | null | Cartier / Zona | "Tomis Nord" |
location.street | string | null | Strada (daca e publica) | "Str. Exemplu 12" |
location.latitude | number | null | Latitudine GPS | 44.186 |
location.longitude | number | null | Longitudine GPS | 28.634 |
description | string | Descriere completa HTML | "..." |
features | string[] | Lista facilitati | ["centrala proprie", "balcon"] |
energy_class | string | null | Clasa energetica (A, B, C...) | "B" |
heating | string | null | Tip incalzire | "centrala proprie" |
photos | string[] | URL-uri fotografii (ordonate) | ["https://..."] |
url | string | Link proprietate pe site agentie | "https://deximo.ro/..." |
agent.name | string | null | Numele agentului | "Ionel Groze" |
agent.phone | string | null | Telefon agent | "+40..." |
agent.email | string | null | Email agent | "ionel@..." |
created_at | string | Data adaugarii (ISO 8601) | "2026-04-01T10:00:00Z" |
updated_at | string | Ultima actualizare (ISO 8601) | "2026-04-05T14:30:00Z" |
7. Mapare tipuri proprietati
| Valoare | Descriere RO | Descriere EN |
|---|---|---|
apartment | Apartament | Apartment |
house | Casa / Vila | House / Villa |
land | Teren | Land |
commercial | Spatiu comercial | Commercial space |
office | Birou | Office |
garage | Garaj / Parcare | Garage / Parking |
studio | Garsoniera | Studio |
8. Mapare tipuri tranzactie
| Valoare | Descriere |
|---|---|
sale | Vanzare |
rent | Inchiriere |
9. Coduri HTTP Status
| Cod | Descriere |
|---|---|
| 200 | Succes |
| 401 | API key lipsa sau invalid |
| 404 | Portal inexistent |
| 429 | Rate limit depasit (Header: Retry-After) |
| 500 | Eroare 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 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
curl "https://api.lukian.ai/api/v2/portals/homezz/feed.json?api_key=YOUR_KEY"curl "https://api.lukian.ai/api/v2/portals/homezz/feed.xml?api_key=YOUR_KEY"curl "https://api.lukian.ai/api/v2/portals/homezz/feed.json?api_key=YOUR_KEY&agency=deximoweb"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