Endpoint metrics — přehled metrik

Přehled endpointu metrics — 55 metrik s víceletou historií v jednom API volání. Finance, vozový park, zaměstnanost, veřejné zakázky a další.

Endpoint metrics (/{dataset}/v3/companies/{ico}/metrics) vrací v jednom volání 55 metrik s víceletými časovými řadami. Pokrývá finanční výsledky, vozový park, zaměstnanost, veřejné zakázky, dotace i skupinové údaje.

Pro detailní specifikaci (parametry, autentizace, formát odpovědi) viz API dokumentaci.

Proč je tento endpoint důležitý

Endpoint metrics je nejkomplexnější zdroj dat o firmě v jednom API volání. Na rozdíl od ostatních endpointů, které vracejí jen aktuální stav, metrics obsahuje historické časové řady — typicky 5-8 let finančních dat, 14 měsíců pracovních nabídek nebo 11 let veřejných zakázek.

Metrics vs aggregated-data

Endpoint aggregated-data obsahuje souhrn přibližně 25 metrik, ale pouze poslední známou hodnotu pro každou metriku. Endpoint metrics je nadmnožina — vrací stejné metriky plus desítky dalších, a to včetně kompletní historie.

	aggregated-data	metrics
Počet metrik	~25	55
Historické hodnoty	ne (jen poslední)	ano (víceleté řady)
Finanční trendy	ne	ano (až 8 let)
Vozový park	základní	14+ metrik s detailem
Nábor a zaměstnanost	základní	měsíční trendy (14 měsíců)
Veřejné zakázky	ne	roční řady (až 11 let)

Doporučení: Pro jakoukoliv analýzu, kde potřebujete trendy nebo srovnání v čase, vždy použijte endpoint metrics.

Přehled dostupných metrik

Níže je přehled metrik podle kategorie. Dostupnost konkrétních metrik závisí na firmě — ne každá firma má všechna data.

Finanční výsledky (až 8 let historie)

Metrika	Co obsahuje
revenue	Tržby (přesná hodnota nebo pásmo, podle dostupnosti účetní závěrky)
ebitda	EBITDA
ebit	EBIT (mezinárodní definice — viz poznámka níže)
netProfit	Čistý zisk
assetsTotal	Celková aktiva
costOfGoodsSold	Náklady na prodané zboží
personnelCost	Osobní náklady
registeredCapital	Základní kapitál

Finanční poměrové ukazatele

Metrika	Co obsahuje
revenueGrowth	Meziroční růst tržeb
ebitMargin	EBIT marže
netProfitMargin	Marže čistého zisku
capitalIntensityRatio	Kapitálová náročnost (aktiva / tržby)
valueAddedRatio	Podíl přidané hodnoty
revenuePerEmployee	Tržby na zaměstnance

Vozový park (14+ metrik)

Metrika	Co obsahuje
vehiclesOperatedTotal	Celkový počet provozovaných vozidel
vehiclesOwnedTotal	Celkový počet vlastněných vozidel
vehiclesOperatedPassenger	Provozované osobní automobily
vehiclesOperatedUtility	Provozovaná užitková vozidla
vehiclesOperatedElectric	Provozovaná elektrická vozidla
vehiclesOperatedPremium	Provozovaná prémiová vozidla
vehiclesRegistered12Months	Nově registrovaná vozidla za posledních 12 měsíců
vehiclesRegistered12MonthsChange	Meziroční změna registrací
vehiclesTopBrand	Nejčastější značka ve flotile

Tip pro analýzu financování: Rozdíl vehiclesOperatedTotal − vehiclesOwnedTotal indikuje počet vozidel na leasing nebo úvěr. Pokud firma provozuje 228 vozidel, ale vlastní jen 40, zbylých 188 je pravděpodobně financovaných.

Zaměstnanost

Metrika	Co obsahuje
employees	Počet zaměstnanců (přesná hodnota nebo pásmo)
employees12MonthsAvgGrowth	Průměrný růst za 12 měsíců
employees24MonthsAvgGrowth	Průměrný růst za 24 měsíců
whiteCollar	Podíl kancelářských pracovníků (0-1)
personnelMonthlyCostPerEmployee	Průměrné měsíční osobní náklady na zaměstnance

Nábor (14měsíční časová řada)

Metrika	Co obsahuje
openJobCountCurrentTotal	Aktuální počet otevřených pozic
openJobCount12MonthsAverage	Průměr za 12 měsíců
openJobCountCurrentTo12MonthsAverage	Poměr aktuální/průměr — ukazuje náborový momentum
openJobCountMonthly	Měsíční trend (14 období)

Interpretace náborového momenta: Poměr > 1.0 znamená, že firma nabírá rychleji než obvykle (růst). Poměr < 0.5 značí výrazné zpomalení náboru.

Veřejné zakázky (až 11 let historie)

Metrika	Co obsahuje
publicContractsSupplierLast12Months	Objem zakázek za posledních 12 měsíců
publicContractsSupplierYearly	Roční časová řada

Dotace

Metrika	Co obsahuje
subsidiesRecipientLast12Months	Přijaté dotace za 12 měsíců
subsidiesRecipientYearly	Roční časová řada

Skupina a vlastnictví

Metrika	Co obsahuje
connectedCompaniesCount	Počet propojených firem
connectedCompaniesAggregatedRevenues	Celkové tržby skupiny
connectedCompaniesAggregatedEmployees	Celkový počet zaměstnanců skupiny
foreignOwnershipShare	Podíl zahraničního vlastnictví
privateOwnershipShare	Podíl soukromého vlastnictví
publicOwnershipShare	Podíl veřejného vlastnictví
ownerAge	Věk vlastníka (fyzická osoba)

Ostatní

Metrika	Co obsahuje
isExporter	Příznak exportéra
isImporter	Příznak importéra
locationCount	Počet provozoven
businessCardsCount	Počet záznamů v katalozích
eshopCount	Počet e-shopů
riskCount	Počet aktivních rizikových signálů
latestFinancialsAvailable	Rok posledních dostupných účetních dat

Na co si dát pozor

EBIT — mezinárodní vs česká definice

Metrika ebit v tomto endpointu používá mezinárodní definici: čistý zisk + úrokové náklady + daň z příjmu. Čeští analytici ale obvykle pod "EBIT" rozumí Provozní výsledek hospodaření (Provozní VH), který vylučuje celý finanční výsledek, nejen úroky.

U firem s významnými neúrokovými finančními položkami (kurzové rozdíly, meziodnikové půjčky, investiční výnosy) se tyto dvě hodnoty mohou výrazně lišit — někdy i s opačným znaménkem. Pokud potřebujete český Provozní VH, najdete ho v endpointu financials jako řádek výkazu.

Metriky nemusí být u každé firmy kompletní

Některé metriky se vztahují jen k určitým typům firem (vozový park, zemědělství). API vrací jen metriky, pro které má data — nepočítejte s tím, že každá firma bude mít všech 55 metrik.

Metrika revenue může mít dva typy

Pokud má firma zveřejněnou účetní závěrku, revenue obsahuje přesnou hodnotu. Pokud ne, obsahuje pouze odhad v pásmu (např. "10-25 mil. Kč"). Kód by měl počítat s oběma variantami.

Často kladené dotazy

Kolik API volání spotřebuji? Jedno volání na jednu firmu — všech 55 metrik přijde v jedné odpovědi.

Jak často se metriky aktualizují? Záleží na datovém zdroji. Finanční data se aktualizují po zveřejnění účetních závěrek, údaje o vozovém parku a zaměstnancích průběžně. Viz Jak často data aktualizujete?

Potřebuji ještě endpoint aggregated-data? Ano — aggregated-data obsahuje základní informace o firmě (název, IČO, NACE, kontakty, indikátory), které v metrics nejsou. Pro kompletní pohled na firmu je ideální kombinace obou endpointů.

Další informace

• Přehled API endpointů

• Hromadné (BULK) API volání

• Kompletní API dokumentace