# Přehled API endpointů *Aktualizováno: 8. dubna 2026* ## Přehled API endpointů Kompletní technická specifikace endpointů (parametry, formát odpovědí, příklady) je v [API dokumentaci](http://developers.bizmachine.com/). Tento článek vám pomůže se v endpointech rychle zorientovat — který použít, v jaké verzi a na co si dát pozor. ### Přehledová tabulka endpointů BizMachine API obsahuje endpointy ve dvou verzích (v3 a v4). Ne každý endpoint je dostupný v obou verzích a některé se ve formátu odpovědi liší. Tabulka níže shrnuje doporučenou verzi pro každý endpoint. | Endpoint | Verze | Typ volání | Co vrací | | ----------------------------------------------------------------------------- | ------ | ------------ | -------------------------------------------------------------------------------------------- | | [aggregated-data](/api-a-integrace/api-endpointy/endpoint-aggregated-data.md) | **v4** | jednofirmové | Základní info, kontakty, indikátory, NACE, souhrn metrik | | [metrics](/api-a-integrace/api-endpointy/endpoint-metrics.md) | **v3** | jednofirmové | 55 metrik s víceletými časovými řadami (finance, vozový park, zaměstnanci, veřejné zakázky) | | [suggest](/api-a-integrace/api-endpointy/endpoint-suggest.md) | **v4** | vyhledávání | Vyhledání firmy podle názvu, IČO, DIČ nebo domény — vrátí IČO pro použití v dalších voláních | | `owners` | **v4** | jednofirmové | Vlastnická struktura s historií a podíly | | `connected-companies` | **v3** | jednofirmové | Propojené firmy (mateřské, dceřiné, přes statutáry) | | `risks` | **v4** | jednofirmové | Rizikové signály (insolvence, exekuce, daňové nedoplatky) | | [contacts](/api-a-integrace/api-endpointy/endpoint-contacts.md) | **v4** | jednofirmové | Telefon, e-mail, web, LinkedIn profily klíčových osob | | `financials` | **v3** | kolekce | Detailní účetní výkazy (rozvaha, výsledovka) po řádcích | | `vehicles` | **v4** | kolekce | Vozidla s vlastnickými řetězci, stránkováno po 250 | | [events](/api-a-integrace/api-endpointy/endpoint-events.md) | **v3** | kolekce | Firemní události (změny v rejstříku, podání) | | `contracts` | **v3** | kolekce | Veřejné zakázky z Registru smluv | | `subsidies` | **v3** | kolekce | Přijaté dotace | | `indicators` | **v3** | jednofirmové | Detailní BizMachine indikátory (aktivita, růst, dosažitelnost) | | `statutories` | **v3** | kolekce | Statutární zástupci (aktuální i historičtí) | | `job-postings` | **v3** | kolekce | Aktuální pracovní nabídky | | `locations` | **v3** | kolekce | Provozovny a sídla | | `bank-accounts` | **v4** | jednofirmové | Registrované bankovní účty | | [eshops](/api-a-integrace/api-endpointy/endpoint-eshops.md) | **v3** | kolekce | Informace o eshopech | > **Tip:** Endpoint `metrics` je pravděpodobně nejhodnotnější jednotlivý endpoint pro firemní analýzu — kombinuje finanční data, vozový park, zaměstnanost i veřejné zakázky v jednom volání s víceletou historií. Viz [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md). > **Poznámka:** Tabulka pokrývá datové endpointy pro čtení firemních údajů. Kompletní seznam včetně endpointů pro správu štítků, vyhledávání a dalších operací najdete v [API dokumentaci](http://developers.bizmachine.com/). ### Dva typy volání API rozlišuje dva vzory volání. Typ závisí na konkrétním endpointu: #### Jednofirmové endpointy IČO se předává přímo v URL cestě: ``` GET /{dataset}/v4/companies/{ico}/aggregated-data GET /{dataset}/v3/companies/{ico}/metrics ``` #### Kolekční endpointy IČO se předává jako query parametr. Výsledky mohou být stránkované: ``` GET /{dataset}/v3/events?Company.NationalIn={ico} GET /{dataset}/v3/financials/reports?Company.NationalIn={ico} ``` > **Pozor — vozidla jsou výjimka:** Endpoint `vehicles` nepoužívá `Company.NationalIn`, ale `Company.UniqueId` ve formátu `{dataset}-company-{ico}` (například `cz-company-12345678`). Pokud použijete špatný parametr, API nevrátí chybu — vrátí nefiltrované výsledky. Podrobnosti v [API dokumentaci](http://developers.bizmachine.com/). ### Dostupné datové sady BizMachine API pokrývá pět trhů. Dataset se předává přímo v URL: | Dataset | Trh | | ------- | --------------- | | `cz` | Česká republika | | `sk` | Slovensko | | `hu` | Maďarsko | | `pl` | Polsko | | `de` | Německo | > **Poznámka:** Šíře dostupných dat se mezi zeměmi liší. Nejbohatší datové pokrytí nabízíme pro Českou republiku a Slovensko. ### Jazyk odpovědí Jazyk dat v odpovědích lze ovlivnit hlavičkou `Accept-Language`. Výchozí jazyk je angličtina. | Hodnota | Jazyk | | ------- | -------------------- | | `EN` | Angličtina (výchozí) | | `CS` | Čeština | | `SK` | Slovenština | ### Autentizace Každý API dotaz musí obsahovat hlavičku s vaším API klíčem: ``` X-Api-Key: {VÁŠ_API_KLÍČ} ``` Jak API klíč vygenerovat: [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md) ### Na co si dát pozor Několik věcí, které při integraci ušetří čas: * **v3 vs v4** — ne každý endpoint funguje v obou verzích. Tabulka výše ukazuje doporučenou verzi. Pokud endpoint ve zvolené verzi neexistuje, API vrátí `UnsupportedApiVersion`. * **Stránkování** — kolekční endpointy vracejí max 250 záznamů na stránku. K dalším stránkám se dostanete parametrem `Offset` (ne `Page`). Viz [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani.md). * **Neznámé parametry** — API tiše ignoruje neznámé query parametry a vrátí nefiltrované výsledky. Pokud dostáváte neočekávaně velký počet záznamů, zkontrolujte správnost názvů parametrů. * **Metriky vs aggregated-data** — `aggregated-data` obsahuje souhrn \~25 metrik (poslední hodnoty). Samostatný endpoint `metrics` vrací 55 metrik s kompletní víceletou historií. Podrobnosti viz [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md). ### Další informace * [Jak si vygeneruji API klíč?](/api-a-integrace/generovani-api-klice.md) * [Co je to integrační účet?](/api-a-integrace/integracni-ucet.md) * [Jaké jsou moje API limity?](/api-a-integrace/api-limity.md) * [Hromadné (BULK) API volání](/api-a-integrace/hromadne-api-volani.md) * [Endpoint metrics — přehled metrik](/api-a-integrace/api-endpointy/endpoint-metrics.md) * [Kompletní API dokumentace](http://developers.bizmachine.com/) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://help.bizmachine.com/api-a-integrace/api-endpointy.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.