LV Link Finder

EN: Apify actor that finds Lists of Ownership (Listy vlastníctva, LV) for a given person or entity across the entire Slovak Republic, without requiring a predefined cadastral unit (katastrálne územie, k. ú.).
SK: Apify actor, ktorý vyhľadá Listy vlastníctva (LV) pre zadanú osobu alebo subjekt naprieč celým Slovenskom, bez potreby poznať konkrétne katastrálne územie (k. ú.).

---

Beyond Business

Beyond commercial use cases, Slovak Cadaster LV Link Finder serves as an anti-corruption tool. By enabling nationwide discovery of property ownership without requiring prior knowledge of cadastral units, the actor significantly lowers the barrier for investigative journalists, NGOs, watchdog organizations,and researchers to uncover hidden asset ownership and potential conflicts of interest. It supports public-interest investigations by making ownership data more accessible, scalable, and verifiable, helping to strengthen transparency, accountability, and informed public discourse.

Overview | Prehľad

EN:
The actor searches internal ownership datasets, navigates the official Slovak cadastral portal interface, and generates direct public PDF links to ownership records hosted by the cadastral portal.
This makes it possible to discover ownership information even when the exact cadastral unit is unknown.

SK:
Actor prehľadáva interné vlastnícke indexy, pracuje s oficiálnym rozhraním slovenského katastrálneho portálu a generuje priame verejné PDF odkazy na listy vlastníctva dostupné na katastrálnom portáli.
Vďaka tomu je možné zistiť vlastnícke vzťahy aj bez znalosti konkrétneho katastrálneho územia.

---

Key Capabilities | Kľúčové funkcie

EN:

• 🔎 Search by first name, last name, or company name
• 🌍 Coverage of all cadastral units in Slovakia
• 📄 Generates direct PDF links to Lists of Ownership (LV)
• 🔤 Supports:
  • Strict search (case-insensitive, accent-sensitive)
  • Loose search (accent-insensitive)
• ⚡ Parallel processing with retries and timeout handling
• 📊 Clean, structured dataset output with success/error separation

SK:

• 🔎 Vyhľadávanie podľa mena, priezviska alebo názvu spoločnosti
• 🌍 Pokrytie všetkých katastrálnych území na Slovensku
• 📄 Generovanie priamych PDF odkazov na listy vlastníctva (LV)
• 🔤 Podpora:
  • Presného vyhľadávania (bez ohľadu na veľkosť písmen, citlivé na diakritiku)
  • Voľného vyhľadávania (bez diakritiky)
• ⚡ Paralelné spracovanie s retry logikou a timeoutmi
• 📊 Prehľadný, štruktúrovaný výstup s oddelením úspechov a chýb

---

How It Works (High-Level) | Ako to funguje (stručne)

EN:

1. The actor searches an internal ownership index for matching owners.
2. For each match, it automatically:
   • Selects the appropriate district (okres)
   • Selects the cadastral unit (k. ú.)
   • Navigates ownership dropdowns (alphabet → surname → owner)
3. It retrieves all available LV / CLV numbers.
4. For each LV, it generates a public PDF URL to the official ownership document.

No prior knowledge of cadastral units is required.

SK:

1. Actor vyhľadá zodpovedajúcich vlastníkov v internom vlastníckom indexe.
2. Pre každú zhodu automaticky:
   • Zvolí správny okres
   • Zvolí katastrálne územie (k. ú.)
   • Naviguje vlastnícke zoznamy (abeceda → priezvisko → vlastník)
3. Získa všetky dostupné čísla LV / CLV.
4. Pre každý LV vygeneruje verejný PDF odkaz na oficiálny dokument.

Nie je potrebná predchádzajúca znalosť katastrálneho územia.

---

Input Parameters | Vstupné parametre

Field	Type	Description (EN)	Popis (SK)
firstName	string	First name or company name	Meno alebo názov spoločnosti
lastName	string	Last name	Priezvisko
district	string	District filter ("Všetky" = all districts)	Filter okresu ("Všetky" = všetky okresy)
looseMatch	boolean	Accent-insensitive search	Vyhľadávanie bez diakritiky

EN: At least one of firstName or lastName must be provided.
SK: Aspoň jedno z polí firstName alebo lastName musí byť vyplnené.

---

Output Dataset | Výstupný dataset

Each dataset item represents either a successfully generated LV PDF link or an error encountered during processing.

Každá položka datasetu reprezentuje buď úspešne vygenerovaný PDF odkaz na LV, alebo chybu vzniknutú počas spracovania.

Successful Item Example | Príklad úspešného záznamu

{
  "okres": "Trnava",
  "ku": "Modranka",
  "owner": "Gazda Ján",
  "clv": "1234",
  "lv_link": "https://kataster.skgeodesy.sk/Portal45/api/Bo/GeneratePrfPublic?prfNumber=1234&cadastralUnitCode=801234&outputType=pdf"
}