Nové sídlo, nový název, přeměna na jinou právní formu, změna základního kapitálu nebo čerstvě zapsaná firma často znamená začátek nákupního cyklu. API sleduje firmy z vašeho CRM, pošle změnu z veřejného rejstříku a vypíše nově vzniklé firmy. Vždy na úrovni firmy, nikdy s osobními údaji pro marketing.
U českých firem API zaznamenává změny názvu, sídla, právní formy, základního kapitálu a stavu a také vznik nové firmy. Událost nese datum, kdy se změna poprvé objevila v datech rejstříku, nikoli datum zápisu. Události existují od prvního načtení v říjnu 2026, starší nejsou.
| Změna v rejstříku | event_type | Proč je to signál pro prodej |
|---|---|---|
| Vznik nové firmy | new_incorporation | Nová firma potřebuje banku, účetní, pojištění, software a prostory |
| Změna sídla | address_change | Nové prostory: stěhování, vybavení, připojení, úklid, místní dodavatelé |
| Změna obchodní firmy | name_change | Nový název často znamená nové vedení nebo nového vlastníka; smlouvy a fakturační údaje se aktualizují |
| Změna základního kapitálu | capital_change | Navýšení kapitálu přináší čerstvé peníze, které se brzy utratí |
| Změna právní formy | legal_form_change | Přeměna přináší novou strukturu, nové smlouvy a často nové úvěrové limity |
| Vstup do likvidace | liquidation | Zastavte prodej na fakturu, zkontrolujte otevřené pohledávky |
| Výmaz z rejstříku, řízení o zrušení | dissolution | Konec vztahu: uzavřete účet v CRM |
| Insolvence, konkurs, reorganizace | insolvency | Nejnaléhavější signál pro pohledávky a obchodní úvěr |
| Návrat do aktivního stavu | reactivation | Firma, kterou jste odepsali, funguje dál |
previous_value a new_value jsou hodnoty zapsané v rejstříku, bez měny (tu najdete v poli capital_currency záznamu firmy). signal_category je u každé změny kapitálu growth, i u snížení, takže směr určíte porovnáním obou hodnot. Prázdná new_value bývá u firem, které zanikly: rejstřík kapitál už neuvádí, o navýšení nejde.112 je s.r.o., 121 a.s. Název ke kódu najdete v poli local_legal_form_name záznamu.new_value.Každou firmu z CRM najděte jednou podle IČO, uložte její id, přihlaste ji k monitoringu a číslo klienta z CRM dejte do pole label: vrátí se s každým upozorněním. Přihlášení nespotřebuje žádné kredity.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
ucty = [('45274649', 'crm-1001'), ('00177041', 'crm-1002')] # IČO a číslo klienta v CRM
for ico, id_crm in ucty:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'CZ', 'company_number': ico})
r.raise_for_status()
nalezeno = r.json()['data']
if nalezeno:
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': nalezeno[0]['id'],
'country': 'CZ',
'label': id_crm, # vrátí se s každým upozorněním
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://vase-domena.cz/hooks/prometiam',
}).raise_for_status()
Každé upozornění přichází podepsané. Hlavička X-Prometiam-Signature nese sha256= a HMAC-SHA256 nezměněného těla požadavku s klíčem webhook_secret, který vrací POST /monitor (zobrazí se jen jednou, uložte si ho). Podpis ověřte dřív, než obchodníkovi založíte úkol. Webhook je na každém tarifu; upozornění přečtete také v GET /monitor, takže stačí i noční skript.
import hashlib, hmac
def podpis_ok(telo: bytes, hlavicka: str, secret: str) -> bool:
"""telo: nezměněné tělo požadavku; hlavicka: X-Prometiam-Signature; secret: webhook_secret z POST /monitor."""
ocekavany = 'sha256=' + hmac.new(secret.encode(), telo, hashlib.sha256).hexdigest()
return hmac.compare_digest(hlavicka, ocekavany)
Než firmu oslovíte, podívejte se, co se v ní změnilo: GET /company-events/search?country=CZ&company_number=45274649 vrátí události jedné firmy (zde ČEZ, a. s.) od nejnovější, za 2 kredity. Hledat lze i podle názvu (company_name). Prázdný seznam znamená jen to, že jsme od prvního načtení v říjnu 2026 neviděli žádnou změnu.
Vynecháte-li IČO i název, je totéž volání proudem událostí celé země: každá změna, kterou jsme v rejstříku viděli, od nejnovější, s filtrem event_type. Sahá nejvýš 31 dní zpět (výchozí je 7), starší date_from skončí chybou 400. Denní nebo týdenní skript, který proud čte a ponechá firmy z vašeho segmentu, najde účty, které zatím nesledujete.
# Změny základního kapitálu za posledních 7 dní, 100 událostí na volání # (date_from: nejvýš 31 dní zpět, výchozí je 7 dní) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=CZ&event_type=capital_change&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Volání stojí 2 kredity a vrací nejvýš 100 událostí, další stránky načtete kurzorem next_cursor. Zajímají vás navýšení kapitálu? Ponechte jen události, u nichž je new_value vyšší než previous_value:
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
r = requests.get(f'{BASE}/company-events/search', headers=H, params={
'country': 'CZ', 'event_type': 'capital_change', 'limit': 100})
r.raise_for_status()
navyseni = [e for e in r.json()['data']
if e['previous_value'] and e['new_value'] and float(e['new_value']) > float(e['previous_value'])]
for e in navyseni:
print(e['event_date'], e['company_number'], e['company_name'], e['previous_value'], '->', e['new_value'])
Vznik je první signál: nová firma potřebuje banku, účetní, pojištění, software i prostory. founded_after vypíše firmy založené od zadaného data bez názvu, stránku po stránce (1 kredit za volání s nejvýš 100 firmami), founded_before okno uzavře. Totéž ohlásí událost new_incorporation v proudu událostí: její event_date je den prvního spatření v rejstříku a datum vzniku je v event_detail.
# Firmy založené od 1. října, od nejnovějších curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=CZ&founded_after=2026-10-01&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Záznam nové firmy nese právní formu, obec, adresu, PSČ a základní kapitál. Kód činnosti CZ-NACE 2025 a kraj pocházejí z Registru ekonomických subjektů ČSÚ a u čerstvě zapsaných firem bývají prázdné, takže podle oboru nebo kraje je nevyfiltrujete. Filtr podle oboru API pro Česko nemá (cnae je jen pro Španělsko a končí chybou 400), segment proto zužujete ve vlastním kódu.
director_change): API vrací jen záznamy o firmách, bez statutárních orgánů, společníků, akcionářů a skutečných majitelů a bez signálu o plnění povinností vůči rejstříku.vat= pro Česko API odmítne.liquidation, insolvency); samotná insolvenční řízení najdete v Insolvenčním rejstříku ministerstva spravedlnosti (isir.justice.cz), který neobsluhujeme.Obsahuje data z veřejných rejstříků České republiky (Ministerstvo spravedlnosti, otevřená data ISVR) a Českého statistického úřadu (RES, CC BY 4.0). Upraveno společností Prometiam. Contains data from the public registers of the Czech Republic (Ministry of Justice, ISVR open data) and the Czech Statistical Office (RES, CC BY 4.0). Adapted by Prometiam.
Monitoring nespotřebovává kredity: tarif určuje, kolik firem sledujete (3 ve zkušebním období, 25 v tarifu Starter, 250 v tarifu Professional a 2 500 v tarifu Scale; webhooky jsou na každém tarifu). Vyhledání firem stojí 1 kredit, vyhledání událostí 2. Starter stojí 9,99 EUR měsíčně (1 000 kreditů), Professional 29,99 EUR (10 000 kreditů), Scale 99,99 EUR (50 000 kreditů). Zkušební období trvá 14 dní a zahrnuje 500 kreditů: vyžaduje platební kartu, během něj se nic neúčtuje a poté pokračuje Starter, pokud jej nezrušíte.
Začněte 14denní zkušební období · Dokumentace API
Zkušební období trvá 14 dní a zahrnuje 500 kreditů. Vyžaduje se platební karta, během zkušebního období se nic neúčtuje; poté pokračuje tarif Starter (9,99 EUR měsíčně), pokud jej nezrušíte.