Přejít k obsahu|Přejít k hlavnímu menu

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": "0dbbe9e57477d3a8b15ad9d63a371467f3cf4399",
		"imageUrl": "https://tmbr.rmcl.cz/c21.cz/estate/i280/280655/w1140h610-kc54c-10de5-svetly-byt-2-kk-51-m2-na-praze-3-zizkov-01-kopie-4163d4acc5.jpg?W87Z4bVU97vZuKi5sh1z/SxnM0F74QA0ePeDFe5H3qBhIfwaata0VMfGPoFa0euOpm7/nFhtHutA4lNMVU4jDL9eQt8cDO8q2NfKpl9DnMpmABmOZ0kjaM+y86TBcfa59NplJR+dpJYg1SrO02Zj13FYOjLSMy/exG8+wSwqyqw7mmEyuxs4vImTjS4tp5CqlB2dIQ6NIMMuV4rd0akMrw==",
		"landArea": null,
		"landType": null,
		"origin": "CENTURY 21",
		"price": 6200000,
		"priceNote": "včetně provize",
		"priceText": "6 200 000",
		"realEstateType": "Apartment",
		"url": "https://www.century21.cz/prodej-byty-2-kk-praha-zizkov-svetly-byt-2-kk-51-m2-na-praze-3-zizkov-280655",
		"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": "0dbbe9e57477d3a8b15ad9d63a371467f3cf4399",
				"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
					}
				}
			}
		]
	}
}

Popis výstupních parametrů

  • realEstate: RealEstate - Nalezená nemovitost, obsahuje rozšíření EXTENDED, LOCATION a STATS