nahlizenidokn.cuzk.gov.cz APInahlizenidokn.cuzk.gov.cz ↗
Search Czech cadastre buildings, parcels, and LV sheets by address or code. Returns property type, area, units, map previews, and cadastral territory data.
curl -X GET 'https://api.parse.bot/scraper/409de72d-4782-4f17-9d12-b4704f010a72/search_building_by_address?query=V%C3%A1clavsk%C3%A9+n%C3%A1m%C4%9Bst%C3%AD+1%2C+Praha' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for building (stavba) details by address string. Uses the ČÚZK autocomplete to find the best match and retrieves the building detail page. Requires Czech-format addresses with street, building number, and city (e.g. 'Václavské náměstí 1, Praha'). Returns stale_input if no matching address is found.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Czech-format address string with street, number, and city (e.g. 'Václavské náměstí 1, Praha', 'Náměstí Republiky 1, Praha'). |
{
"type": "object",
"fields": {
"url": "string, URL of the detail page on ČÚZK",
"obec": "object with text and url for the municipality",
"title": "string, page title (e.g. 'Informace o stavbě')",
"stavba": "string, building number",
"map_url": "string, URL to map preview image",
"jednotky": "array of unit objects with cislo and url",
"typ_stavby": "string, building type",
"zpusob_vyuziti": "string, usage type",
"katastralni_uzemi": "object with text and url for the cadastral territory"
},
"sample": {
"data": {
"url": "https://nahlizenidokn.cuzk.gov.cz/ZobrazObjekt.aspx?encrypted=NAHL~...",
"obec": {
"url": "https://vdp.cuzk.gov.cz/vdp/ruian/obce/554782",
"text": "Praha [554782]"
},
"title": "Informace o stavbě",
"stavba": "č. p. 632",
"map_url": "https://sgi-nahlizenidokn.cuzk.gov.cz/marushka/handlers/vratlokalizacninahled.ashx?ThemeID=3&MarWidth=320&MarHeight=240&MarQueryID=0F9BFD8B&MarQParam0=884918101&MarQParamCount=1",
"cislo_lv": {
"url": "https://nahlizenidokn.cuzk.gov.cz/ZobrazObjekt.aspx?encrypted=NAHL~...",
"text": "2008"
},
"jednotky": [
{
"url": "https://nahlizenidokn.cuzk.gov.cz/ZobrazObjekt.aspx?encrypted=NAHL~...",
"cislo": "632/1"
}
],
"cast_obce": {
"url": "https://vdp.cuzk.gov.cz/vdp/ruian/castiobce/490261",
"text": "Žižkov [490261]"
},
"typ_stavby": "budova s číslem popisným",
"zpusob_vyuziti": "bytový dům",
"katastralni_uzemi": {
"url": "https://nahlizenidokn.cuzk.gov.cz/VyberKatastrInfo.aspx?encrypted=NAHL~...",
"text": "Žižkov [727415]"
}
},
"status": "success"
}
}About the nahlizenidokn.cuzk.gov.cz API
This API exposes 5 endpoints covering the Czech Land Registry (Nahlížení do katastru nemovitostí), returning structured property data for buildings, parcels, land registry sheets, and cadastral territories. The search_building_by_address endpoint accepts a Czech-format address and returns fields such as typ_stavby, zpusob_vyuziti, jednotky (unit list with URLs), and a map_url preview. Other endpoints resolve parcels, LV sheets, and cadastral territory codes from the same source.
Building and Parcel Lookups by Address
search_building_by_address accepts a Czech-format address string (e.g. Václavské náměstí 1, Praha) and returns the building's type (typ_stavby), usage classification (zpusob_vyuziti), cadastral territory (katastralni_uzemi with text and URL), a list of individual units (jednotky with unit number and URL), and a map_url linking to the ČÚZK map preview. search_parcel_by_address works from the same address input but navigates to the underlying land parcel, returning parcelni_cislo, druh_pozemku (land type), vymera_m2 (area in square metres), and cadastral territory details. Both endpoints return stale_input when no matching address is found in the cadastre.
Token-Based Detail and LV Sheet Access
get_object_details accepts an encrypted session token (starting with NAHL~) sourced from the url fields returned by other endpoints. This lets you retrieve detail pages for any object type — building, parcel, or unit — using the token parameter without re-running an address search. search_lv looks up a land registry sheet (list vlastnictví) by cadastral territory code (ku, e.g. 600938 for Staré Město) and LV number (lv), returning the page URL and title. Note that full LV contents — ownership names, complete property lists — are gated behind government ID (NIA) authentication and are not returned.
Cadastral Territory Discovery
get_cadastral_territory_info accepts a keyword (e.g. Žižkov, Smíchov) and returns a suggestions array of matching cadastral territories, each with a numeric data code and a value string combining name and code. These codes feed directly into the ku parameter of search_lv, making territory discovery a practical first step when you don't already know the cadastral code for an area.
- Retrieve building type and usage classification for a Czech address to populate a real estate database.
- Look up the land area (
vymera_m2) and land type (druh_pozemku) for a parcel before a property transaction. - Enumerate all individual units (
jednotky) in a building to build an apartment-level index. - Resolve cadastral territory codes by name using
get_cadastral_territory_infobefore querying LV sheets. - Fetch map preview URLs (
map_url) for buildings or parcels to display in a property information tool. - Verify whether a building or parcel exists in the Czech cadastre before processing address data.
- Follow token URLs from building searches to retrieve linked unit detail pages via
get_object_details.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ČÚZK provide an official developer API for Nahlížení do katastru nemovitostí?+
What does `search_lv` actually return, and can I get ownership names from it?+
search_lv endpoint returns the LV sheet's page URL and title. Ownership names, mortgage details, and the full property list on an LV sheet require government ID (NIA) authentication on the ČÚZK side and are not accessible through this API. The API covers building characteristics, parcel geometry, and unit listings available from the public-facing cadastre pages.Can I search by parcel number or cadastral territory code directly, without an address?+
search_lv does accept a cadastral territory code and LV number directly. You can fork this API on Parse and revise it to add a parcel-number-based lookup endpoint.What happens when the address query doesn't match anything in the cadastre?+
search_building_by_address and search_parcel_by_address both return a stale_input indicator when the autocomplete finds no matching record. This typically happens when the address is outside the ČÚZK index, formatted incorrectly, or uses a non-Czech locale. The address must include street name, building number, and city to be matched reliably.