RealEstate
Žádost a přidělení API klíče
API klíč je vázaný na registrovaného uživatele Visidoo.
Pokud jste registraci ještě neprovedli, tak ji naleznete pod odkazem Přihlášení v horním menu a následně odkazem Chci se registrovat v zobrazeném modalu. Dále postupujte podle instrukcí.
Po registraci zašlete žádost o přidělení API klíče pro registrovaný e-mail na adresu podpora@visidoo.cz. API klíč vám bude co nejdříve vygenerován.
Základní informace
- HTTP metoda:
GET - Endpoint:
https://api.visidoo.com/v1/real-estate - MIME typ:
application/json - Autorizace:
Authorization: Bearer [váš přidělený api klíč] - Query parametry:
- url - Url hledaného inzerátu (dejte pozor, aby byla správně zakódovaná pro přenos v url, např. v js pomocí funkce encodeURIComponent)
Příklad odpovědi
{
"realEstate": {
"adType": "Sale",
"area": 51,
"createdAt": "2022-10-19T16:13:50.230Z",
"deletedAt": null,
"disposition": "2+kk",
"gps": [
14.46683999,
50.0888403344
],
"id": "8f1146f5ac14898baad0d908b5d9a1a6b6b35000",
"imageUrl": "https://d18-a.sdn.cz/d_18/c_img_QJ_Jf/kjRpYE.jpeg?fl=res,749,562,3|shr,,20|jpg,90",
"landArea": null,
"landType": null,
"origin": "Sreality",
"price": 6200000,
"priceNote": "včetně provize",
"priceText": "6 200 000",
"realEstateType": "Apartment",
"url": "https://www.sreality.cz/detail/prodej/byt/2+kk/praha-zizkov-zerotinova/2145072972",
"extended": {
"basement": true,
"buildingType": "Brick",
"conditionType": "Good",
"description": "Nabízíme na prodej pěkný, světlý byt 2+kk v Žerotínově ulici na Žižkově. Byt se nachází ve 2. patře rohového zrekonstruovaného činžovního domu s výtahem. Tvoří ho předsíň, obývací pokoj s kuchyňskou linkou, ložnice, koupelna s vanou, samostatné WC a komora. Byt má nová dřevěná špaletová okna, v ložnici jsou kvalitní parkety, v obývacím pokoji plovoucí podlaha, nový elektrický bojler. K bytu náleží sklep, který není započtený v podlahové ploše bytu, dále podíl na společném balkoně v mezipatře a také podíl na nebytových jednotkách v domě, ze kterých má vlastník bytu pravidelný příjem. Dále je v domě kolárna. 2 minuty pěšky na stanici tram a busu Biskupcova, v okolí mnoho obchodů a restaurací, parky Parukářka a Vítkov, sportovní areál Pražačka.",
"elevator": true,
"floor": 3,
"houseType": null,
"landWidth": null,
"ownershipType": "Direct",
"parkingType": null,
"terraceType": "Balcony",
"title": "Prodej bytu 2+kk 51 m²",
"updatedAt": "2022-10-21T09:01:52.855Z"
},
"location": {
"country": "Česko",
"level": 10,
"city": "Praha",
"part": "Žižkov",
"district": "okres Hlavní město Praha",
"name": "Žižkov",
"id": "-428824",
"cohesion": "Praha",
"region": "Hlavní město Praha"
},
"stats": [
{
"realEstateId": "8f1146f5ac14898baad0d908b5d9a1a6b6b35000",
"source": "VisidooPrice",
"stats": {
"sale": {
"average": 6776244,
"median": 6494500,
"range": [
4300000,
16865000
],
"sample": 178,
"distance": 8
},
"rent": {
"average": 25023,
"median": 17834,
"range": [
10000,
1120000
],
"sample": 171,
"distance": 8
}
}
},
{
"realEstateId": "8f1146f5ac14898baad0d908b5d9a1a6b6b35000",
"source": "CityPerformer",
"stats": {
"indices": {
"overall": 8.59,
"mobility": 9.3,
"wellbeing": 9.36,
"relax": 7.48,
"safety": 9.48,
"services": 9.15,
"environment": 7.46
},
"shareUrl": "https://app.cityperformer.com/share/453897777873684455/analysis/overview?share=cSnIlfrFhEgZzuFTEigbYolobBssJTkOzaitgrWP",
"pricePercentile": null,
"rentPrice": null,
"salePrice": null,
"daysOnMarket": null
}
},
{
"realEstateId": "8f1146f5ac14898baad0d908b5d9a1a6b6b35000",
"source": "Valuo",
"stats": {
"sale": {
"average": 6186759,
"median": null,
"range": [
5798445,
6575073
],
"sample": 0,
"distance": 2
},
"rent": {
"average": 16320,
"median": null,
"range": [
14178,
18462
],
"sample": 0,
"distance": 2
}
}
}
]
}
}Popis výstupních parametrů
- realEstate: RealEstate - Nalezená nemovitost, obsahuje rozšíření EXTENDED, LOCATION a STATS