leadmaker API
JSON přes HTTPS na https://api.leadmaker.cz/v1/. Stejná data jako na webu: přes 950 000 právnických osob v ČR s obory, velikostí, výkazy, weby, kontakty a rizikovými signály, a k tomu otevřené veřejné zakázky ze všech zákonných kanálů. Fyzické osoby podnikající v API nejsou.
Založit účet a získat API klíč Klíč vznikne v okamžiku založení účtu.
Přihlášení klíčem
Každý dotaz mimo tento web nese API klíč. Klíč dostanete jen při založení účtu, ukážeme ho jednou a u nás zůstává pouze jeho otisk. V účtu vidíte využití po dnech. Ztracený nebo uniklý klíč zneplatní podpora (podpora@apertia.cz).
curl -H "X-API-Key: $LEADMAKER_KEY" https://api.leadmaker.cz/v1/company/27117758 curl -H "Authorization: Bearer $LEADMAKER_KEY" https://api.leadmaker.cz/v1/company/27117758
Pro rychlé stažení CSV do Excelu funguje i parametr ?api_key=. Do skriptů ale patří hlavička, ať klíč nezůstává v historii a logech.
| limity | 10 000 dotazů denně na klíč (obnova o půlnoci), nejvýš 300 za minutu; zbytek na dnešek v hlavičce X-Quota-Remaining |
| 401 | api_key_required chybí klíč · invalid_api_key neplatný nebo zneplatněný klíč · account_required CSV je pro přihlášené |
| 429 | rate_limited (počkejte retry_after_s) · quota_exceeded denní limit vyčerpán |
| 400 / 404 | invalid_ico, bad_request, not_found |
Vyzkoušejte
Tady na webu se dotaz spustí bez klíče.
…
GET/api/v1/suggest?q=
Našeptávání při psaní: až 8 firem podle prefixu IČO, začátku názvu, slov v názvu a obce („pekárna brno“), nakonec s tolerancí překlepů. Odpověď do pár milisekund.
curl -H "X-API-Key: $LEADMAKER_KEY" "https://api.leadmaker.cz/v1/suggest?q=strojirny%20plzen"
GET/api/v1/company/{ico}
Kompletní profil: základní údaje, obor (CZ-NACE), kraj, obrat a výsledek po letech (v Kč), riziko s důvody, web s mírou jistoty, kontaktní e-mail a telefon, vedení a vlastníci, posledních 12 veřejných zakázek jako dodavatel i zadavatel, právní události a podobné firmy.
curl -H "X-API-Key: $LEADMAKER_KEY" https://api.leadmaker.cz/v1/company/27117758
GET/api/v1/search
Filtrovaný seznam pro obchod a analýzy. Parametry:
| q | část názvu |
| kraj | kód kraje, např. CZ064 (seznam v /api/v1/facets) |
| nace | prefix CZ-NACE, např. 25 nebo 2562 |
| min_emp | minimální počet zaměstnanců (dolní hranice pásma) |
| nace_any | 1 = obor nace i jako vedlejší činnost podle RES, ne jen hlavní |
| web, eshop, contracts | 1 = má ověřený web / prodává online / dodává státu |
| all | 1 = včetně zaniklých |
| sort | rank (výchozí), turnover, name |
| limit, offset | stránkování, max. 100 (CSV 500) |
| format | csv = soubor pro Excel (středník, UTF-8) |
curl -H "X-API-Key: $LEADMAKER_KEY" "https://api.leadmaker.cz/v1/search?kraj=CZ064&nace=25&min_emp=50&web=1&format=csv" -o firmy.csv
GET/api/v1/facets
Číselníky krajů a oborů a souhrnné počty.
GET/api/v1/tenders
Otevřené veřejné zakázky z Věstníku a NEN, profilů zadavatelů (strukturovaná data podle vyhlášky 345/2023 Sb.), TED, dotačních portálů a webů zadavatelů. Nové se objeví do hodiny.
| q | slova v názvu, předmětu a zadavateli |
| cpv | prefix CPV, např. 72 (IT) nebo 45 (stavby) |
| kraj | kód kraje zadavatele, např. CZ064 |
| min_value | předpokládaná hodnota alespoň (Kč) |
| source | statni, profily, ted, dotace, weby |
| deadline_days | lhůta pro nabídky končí do N dnů |
| buyer | IČO zadavatele |
| since | jen zakázky, které jsme poprvé zachytili po tomto čase (ISO 8601, např. 2026-10-08T06:00:00Z); pro pravidelné stahování jen novinek |
| sort | deadline (výchozí), published, value |
| limit, offset, format | max. 100 (CSV 1000), csv = soubor pro Excel |
curl -H "X-API-Key: $LEADMAKER_KEY" "https://api.leadmaker.cz/v1/tenders?cpv=72&deadline_days=14&sort=value"
GET/api/v1/tender/{klíč}
Detail zakázky: stav, lhůty, části, účastníci a nabídkové ceny, dokumenty a kde a kdy jsme ji zachytili. Klíč (tender_key ze seznamu) obsahuje lomítka a dvojtečky, posílejte ho URL-kódovaný.
GET/api/v1/operator?domain=
Kdo provozuje web: firma, jejíž vlastní web je tato doména (IČO na webu a doména odpovídající názvu), u subdomény i nadřazená doména. Web, který jen zmiňuje cizí IČO, provozovatelem nedělá.
GET/api/v1/vat?dic=
Živé ověření v registru plátců DPH (Ministerstvo financí): unreliable = NE (spolehlivý plátce), ANO (nespolehlivý plátce) nebo NENALEZEN (není v registru), finanční úřad, název, adresa a zveřejněné bankovní účty s datem zveřejnění. Přijímá IČO i DIČ s předponou CZ. Ručně: ověření plátce DPH.
curl -H "X-API-Key: $LEADMAKER_KEY" "https://api.leadmaker.cz/v1/vat?dic=CZ27082440"
GET/api/v1/tender-facets
Souhrn otevřených zakázek (počty, končí do 7 dnů, nové za 24 h, hodnota) a rozpad podle oborů CPV.
Zdroje a aktualizace
ARES a ČSÚ RES (firmy), Sbírka listin (účetní závěrky), obchodní rejstřík (vedení, vlastníci), registr smluv (veřejné zakázky), ISIR a ADIS (insolvence, DPH), vlastní sken 1,3 mil. domén .cz (weby, e-shopy, kontakty). Kontaktní údaje jsou firemní adresy zveřejněné na webech firem; osobní e-maily vyřazujeme.