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