# Documentație: https://imobox.ro/knowledge-graph-index.json (Motor Căutare AI și DataFeed)
Acest fișier acționează ca un API intern (endpoint) care returnează o listă de anunțuri imobiliare formatată conform standardului Schema.org `DataFeed`. Mai important, integrează **motorul intern complet de procesare a limbajului natural (NLP)** al platformei ImoBox, permițând interogări textuale extrem de complexe, pe care un AI le poate apela direct, la fel ca utilizatorii umani.
## Cum funcționează:
1. **Analiza NLP avansată (Parametrul `q`)**: Interogarea primită este trecută prin modulul Motor Intern NLP. Textul este analizat pentru a intelege automat intențiile (vânzare/închiriere), tipul imobilului, limite de preț, numărul de camere sau dimensiunile (mp, hectare).
2. **Paginare & Rezultate**: Servește numărul exact de elemente dorit, adăugând metadate (total de pagini, total de anunțuri potrivite) utile pentru agenții AI care îl interoghează.
---
## Parametrii acceptați (Metoda GET)
### 1. `q` (Interogare NLP Liberă)
- **Descriere:** Inima motorului de căutare. Acceptă limbaj natural uman. Modulul detectează și aplică automat următoarele:
- **Tip Imobil:** Identifică termeni precum: *casă, vilă, pensiune, teren, parcelă, apartament, garsonieră, studio, spațiu comercial, magazin, showroom, restaurant, clinică, birou, birouri, office, hală, depozit, spațiu industrial* și le interpretează corect la categoria principală potrivită.
- **Tip Ofertă (Intenție):** Diferențiază automat dacă se caută oferte de *închiriere* sau *vânzare*.
- **Localizare specifică:** Recunoaște inteligent locațiile și sectoarele (ex: *sector 2*, *sectorul 4*).
- **Număr camere:** Convertit inteligent din text ("trei camere", "o cameră", "garsonieră") sau cifre exacte ("3 camere") pentru o filtrare precisă.
- **Expresii comportamentale:** Detectează expresii specifice de piață ca *casă bătrânească* sau *teren ieftin* și adaptează automat criteriile de căutare.
- **Bugete maxime:** Recunoaște cerințe precum *buget maxim 100000 euro* sau *preț maxim 80000 e*. Înțelege diferența dintre prețul total și prețul pe metru pătrat acolo unde se aplică.
- **Estimări de preț:** Un termen de genul *80000 euro* permite explorarea rezultatelor din proximitatea acelei valori pentru a asigura oferte relevante, evaluând inclusiv prețurile per mp.
- **Suprafețe (mp, hectare):** Standardizează și procesează expresii ca *1.5 hectare* sau *15000 mp*, returnând rezultate relevante pentru cerința dimensională.
- **Tip:** String
- **Exemple de utilizare și puterea motorului NLP:**
Puteți interoga API-ul folosind parametrul `q` pentru căutări complexe în limbaj natural. Motorul recunoaște și înțelege intenția utilizatorului în mod automat. Iată câteva exemple concrete de URL-uri de interogare:
- [https://imobox.ro/knowledge-graph-index.json?q=casa+ieftina+sector+1](https://imobox.ro/knowledge-graph-index.json?q=casa+ieftina+sector+1)
*Descriere:* Sistemul înțelege intenția de a căuta o casă în București, Sectorul 1, evaluând preferința pentru un preț redus.
- [https://imobox.ro/knowledge-graph-index.json?q=teren+1.5+hectare+20+euro+mp](https://imobox.ro/knowledge-graph-index.json?q=teren+1.5+hectare+20+euro+mp)
*Descriere:* Sistemul înțelege intenția de localizare și dimensiune a unui teren exprimat în hectare (1.5 ha), corelând automat suprafața cu bugetul dorit per metru pătrat.
- [https://imobox.ro/knowledge-graph-index.json?q=apartament+trei+camere+buget+120000+euro](https://imobox.ro/knowledge-graph-index.json?q=apartament+trei+camere+buget+120000+euro)
*Descriere:* Sistemul înțelege intenția de a găsi apartamente cu structură de trei camere și încadrarea într-un buget total de 120.000 EUR.
- [https://imobox.ro/knowledge-graph-index.json?q=garsoniera+de+inchiriat+unirii](https://imobox.ro/knowledge-graph-index.json?q=garsoniera+de+inchiriat+unirii)
*Descriere:* Sistemul înțelege intenția de închiriere pentru un spațiu de tip garsonieră (o singură cameră) în zona de interes Unirii.
- [https://imobox.ro/knowledge-graph-index.json?q=teren+intre+500+si+1000+mp+buget+30000+euro](https://imobox.ro/knowledge-graph-index.json?q=teren+intre+500+si+1000+mp+buget+30000+euro)
*Descriere:* Sistemul înțelege intenția de a găsi un teren cu limite dimensionale precise (între 500 și 1000 mp) și un buget total specificat de 30.000 EUR.
### 2. `pagina` (Paginare)
- **Descriere:** Numărul paginii curente dorite.
- **Tip:** Integer (Valoare implicită: `1`)
- **Exemplu:** `?pagina=2`
### 3. `limit` (Limita de rezultate pe pagină)
- **Descriere:** Numărul de rezultate per solicitare. Este plafonat la 100 pentru siguranță.
- **Tip:** Integer (Valoare implicită: `25`, Maxim: `100`)
- **Exemplu:** `?limit=50`
---
## Structură Răspuns (JSON)
Răspunsul este perfect compatibil cu standardele stricte `Schema.org`. Entitățile sunt expuse ca oferte comerciale (`Offer`), fiecare conținând un `itemOffered` reprezentând imobilul fizic (`Apartment`, `House`, `Place` etc.).
Informațiile de preț pe metru pătrat respectă formatul `priceSpecification`, iar atributele extra (cum ar fi `propertyType`, `transactionType` și suprafața terenului `lotSize`) sunt mapate curat prin `additionalProperty` sub formă de `PropertyValue` pentru o indexare perfectă.
```json
{
"requestInfo": {
"status": "success",
"query": {
"q": "\"apartamente și case\""
},
"totalResults": 3,
"page": 1,
"resultsPerPage": 25,
"totalPages": 1
},
"dataFeed": {
"@context": "https://schema.org",
"@type": "DataFeed",
"name": "ImoBox Listings",
"dateModified": "2026-05-23T00:00:00+03:00",
"dataFeedElement": [
{
"@type": "DataFeedItem",
"identifier": "EX1234567890ABCDEF1234567890ABCDEF123456",
"url": "https://imobox.ro/apartament-exemplu-2-camere-zona-centrala/anunt/EX1234567890ABCDEF1234567890ABCDEF123456",
"sameAs": "https://imobox.ro/apartament-exemplu-2-camere-zona-centrala/anunt/EX1234567890ABCDEF1234567890ABCDEF123456/knowledge-graph.json",
"dateModified": "2026-05-20T10:00:00+03:00",
"item": {
"@type": "Offer",
"name": "Apartament 2 camere luminos - Zonă Centrală (Exemplu)",
"description": "Apartament de Vanzare in Bucuresti, Sector 1",
"price": 85000,
"priceCurrency": "EUR",
"businessFunction": "http://purl.org/goodrelations/v1#Sell",
"itemOffered": {
"@type": [
"Apartment",
"Accommodation"
],
"address": {
"@type": "PostalAddress",
"addressLocality": "Bucuresti",
"addressRegion": "Sector 1"
},
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "propertyType",
"value": "Apartament"
},
{
"@type": "PropertyValue",
"name": "transactionType",
"value": "Vanzare"
}
],
"numberOfRooms": 2,
"floorSize": {
"@type": "QuantitativeValue",
"value": 55,
"unitCode": "MTK"
}
}
}
},
{
"@type": "DataFeedItem",
"identifier": "EX9876543210FEDCBA9876543210FEDCBA987654",
"url": "https://imobox.ro/teren-constructie-casa-exemplu/anunt/EX9876543210FEDCBA9876543210FEDCBA987654",
"sameAs": "https://imobox.ro/teren-constructie-casa-exemplu/anunt/EX9876543210FEDCBA9876543210FEDCBA987654/knowledge-graph.json",
"dateModified": "2026-05-21T11:30:00+03:00",
"item": {
"@type": "Offer",
"name": "Teren pentru construcție casă - Acces utilități (Exemplu)",
"description": "Teren de Vanzare in Ilfov, Otopeni",
"price": 50000,
"priceCurrency": "EUR",
"businessFunction": "http://purl.org/goodrelations/v1#Sell",
"itemOffered": {
"@type": [
"Place",
"Accommodation"
],
"address": {
"@type": "PostalAddress",
"addressLocality": "Otopeni",
"addressRegion": "Ilfov"
},
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "propertyType",
"value": "Teren"
},
{
"@type": "PropertyValue",
"name": "transactionType",
"value": "Vanzare"
},
{
"@type": "PropertyValue",
"name": "lotSize",
"value": 500,
"unitCode": "MTK"
}
]
},
"priceSpecification": {
"@type": "UnitPriceSpecification",
"price": 100,
"priceCurrency": "EUR",
"referenceQuantity": {
"@type": "QuantitativeValue",
"value": 1,
"unitCode": "MTK"
}
}
}
},
{
"@type": "DataFeedItem",
"identifier": "EX55555555555555555555555555555555555555",
"url": "https://imobox.ro/casa-de-inchiriat-3-camere-curte-proprie-exemplu/anunt/EX55555555555555555555555555555555555555",
"sameAs": "https://imobox.ro/casa-de-inchiriat-3-camere-curte-proprie-exemplu/anunt/EX55555555555555555555555555555555555555/knowledge-graph.json",
"dateModified": "2026-05-22T09:15:00+03:00",
"item": {
"@type": "Offer",
"name": "Casă de închiriat 3 camere cu curte proprie (Exemplu)",
"description": "Casa de Inchiriere in Brasov, Brasov",
"price": 750,
"priceCurrency": "EUR",
"businessFunction": "http://purl.org/goodrelations/v1#LeaseOut",
"itemOffered": {
"@type": [
"House",
"Accommodation"
],
"address": {
"@type": "PostalAddress",
"addressLocality": "Brasov",
"addressRegion": "Brasov"
},
"additionalProperty": [
{
"@type": "PropertyValue",
"name": "propertyType",
"value": "Casa"
},
{
"@type": "PropertyValue",
"name": "transactionType",
"value": "Inchiriere"
},
{
"@type": "PropertyValue",
"name": "lotSize",
"value": 300,
"unitCode": "MTK"
}
],
"numberOfRooms": 3,
"floorSize": {
"@type": "QuantitativeValue",
"value": 110,
"unitCode": "MTK"
}
}
}
}
]
}
}
```
Se încarcă documentația...