Uus nimi, uus aadress, kapitali muutus või õigusliku vormi vahetus on sageli hetk, mil ettevõte hakkab ostma. API jälgib sinu CRM-i ettevõtteid, teatab muudatusest e-äriregistri andmete põhjal ja loetleb äsja registreeritud ettevõtted. Alati ettevõtte tasandil, mitte inimeste andmetega turunduseks.
Müügisignaal on registrimuudatus, mille järel ettevõte hakkab sageli tarnijaid valima. Eesti kohta annab API järgmised sündmused:
| Muudatus registris | event_type | Miks see müügile oluline on |
|---|---|---|
| Uus ettevõte registreeritud | new_incorporation | Uus ettevõte vajab pangakontot, raamatupidajat, kindlustust, tarkvara ja ruume |
| Nimevahetus | name_change | Uus bränd või uued omanikud avavad lepingud, arveldusandmed ja süsteemid uuesti |
| Aadressi muutus | address_change | Uus kontor: sisustus, side, turvateenused ja kohalikud tarnijad |
| Osa- või aktsiakapitali muutus | capital_change | Omanikud panustavad raha, mis kulutatakse varsti |
| Õigusliku vormi muutus | legal_form_change | Ümberkorraldus, näiteks UÜ-st OÜ-ks: lepingud ja dokumendid vaadatakse üle |
| Likvideerimine ja pankrot | liquidation, insolvency | Peata müük, kaitse arve ja puhasta CRM |
| Kustutamine registrist | dissolution, other | Ettevõtet enam ei ole: sulge võimalus ja puhasta CRM |
| Tagasi tegevusse | reactivation | Ettevõte on taas aktiivne, näiteks likvideerimiselt tagasi: uus võimalus |
Sündmused on registrimuudatused: ärinimi, staatus, õiguslik vorm, registreeritud aadress ning osa- või aktsiakapital. Kuupäev on päev, mil muudatus registriandmetes esimest korda nähtavaks sai, mitte registrikande kuupäev, ja sündmusi ei ole enne 30. septembrit 2026. Juhatuse liikmeid Eesti kohta API ei anna, seega juhatuse vahetust (director_change) siit ei tule.
Väljad previous_value ja new_value näitavad vana ja uut väärtust. Kapital võib ka väheneda, seega võrdle kahte numbrit, enne kui kirjutad „kapital kasvas“. Aadressisündmuse tühi new_value tähendab, et aadress on andmetest kadunud, mitte et ettevõte on kolinud: jäta need välja. Kapitali valuuta on ettevõtte kirjes (capital_currency).
Leia iga sihtettevõtte kirje üks kord, pane ta seire alla ja salvesta oma CRM-i tunnus väljale label: see tuleb tagasi igas teates. Seire haldamine ei maksa krediite.
import requests
BASE = 'https://api.prometiam.com/functions/v1/risk-api'
H = {'Authorization': 'Bearer rk_live_...'}
sihtettevotted = [('10060701', 'crm-1001'), ('10421629', 'crm-1002')] # registrikood ja CRM-i tunnus
for kood, crm_id in sihtettevotted:
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'EE', 'company_number': kood})
r.raise_for_status()
leitud = r.json()['data']
if leitud:
requests.post(f'{BASE}/monitor', headers=H, json={
'company_id': leitud[0]['id'],
'country': 'EE',
'label': crm_id,
'events': ['corporate_event', 'status_change', 'dissolution'],
'webhook_url': 'https://example.com/hooks/prometiam',
}).raise_for_status()
Iga teade tuleb allkirjastatult: päis X-Prometiam-Signature sisaldab sha256= ja sõnumi keha HMAC-SHA256 väärtust, mis on arvutatud webhook_secret-iga; selle annab POST /monitor vastuses ainult üks kord, seega salvesta see. Kontrolli allkirja enne, kui tekitad kliendihaldurile ülesande. Teates on sinu label, alert_type (näiteks corporate_event) ja detail.event_type (näiteks address_change).
Veebihaak on igas paketis. Teated saab kätte ka päringuga GET /monitor, nii et sobib ka öine skript. Jälgitavate ettevõtete arv: prooviperioodil 3, Starter 25, Professional 250 ja Scale 2 500. Enne esimest kõnet näed ühe sihtettevõtte viimaseid muudatusi päringuga GET /company-events/search?country=EE&company_number=10060701 (2 krediiti); tühi loend tähendab, et muudatust pole veel nähtud.
Jäta ettevõtte nimi ja registrikood ära ning sama päring on riigi sündmuste voog: kõik muudatused, mis registriandmetes nähtavaks on saanud, uuemad enne, event_type järgi filtreeritult. Voog katab kuni 31 viimast päeva (vaikimisi 7), nii et päevane või nädalane skript, mis loeb voogu ja jätab alles sinu segmendile sobivad ettevõtted, leiab need, mida sa veel ei jälgi.
# Viimase 7 päeva kapitalimuudatused Eestis (kuni 100 sündmust päringu kohta) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=EE&event_type=capital_change&limit=100' \ -H 'Authorization: Bearer rk_live_...' # Aadressimuudatused viimase 7 päeva jooksul (date_from ei tohi olla vanem kui 31 päeva) curl 'https://api.prometiam.com/functions/v1/risk-api/company-events/search?country=EE&event_type=address_change&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Päring maksab 2 krediiti kuni 100 sündmuse eest; järgmise lehe annab next_cursor. Vanem kui 31 päeva date_from annab vea 400 validation_error, mis ei maksa midagi. Eesti voog annab tüübid new_incorporation, name_change, address_change, capital_change, legal_form_change, liquidation, insolvency, dissolution, reactivation ja other (ettevõtet pole enam registriandmetes).
Sündmuses on ettevõtte nimi ja registrikood, aga mitte tegevusala ega linna. Oma segmendi leidmiseks ava kirje päringuga GET /companies/search?country=EE&company_number=... (1 krediit) ja loe activity_code ning city. Kapitalisündmus näeb välja nii (ettevõtte väljad on ära jäetud):
{
"event_type": "capital_change",
"act_type": "capital_change",
"event_date": "2026-10-19",
"previous_value": "200",
"new_value": "4200",
"event_detail": "Share capital changed"
}
Asutamine on esimene signaal: uus ettevõte vajab panka, raamatupidajat, kindlustust, tarkvara ja ruume. founded_after loetleb alates kuupäevast asutatud ettevõtted ilma nimeta, uuemad enne, 100 kaupa; järgmise lehe annab next_cursor. Päring maksab 1 krediidi.
# Alates 1. oktoobrist asutatud ettevõtted, uuemad enne (100 päringu kohta) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=EE&founded_after=2026-10-01&limit=100' \ -H 'Authorization: Bearer rk_live_...'
Tulemuses on lisaks osaühingutele (OÜ) ka usaldusühinguid (UÜ), mittetulundusühinguid (MTÜ) ja korteriühistuid (KÜ), seega filtreeri legal_form järgi:
# BASE ja H on samad, mis eespool
r = requests.get(f'{BASE}/companies/search', headers=H,
params={'country': 'EE', 'founded_after': '2026-10-01', 'limit': 100})
r.raise_for_status()
uued = [c for c in r.json()['data'] if c['legal_form'] in ('OÜ', 'AS') and c['status'] == 'active']
Kirje sisaldab founding_date, legal_form, osa- või aktsiakapital (capital_amount, capital_currency) ja tegevusala (activity_code, EMTAK), kui register selle annab. Teine võimalus on voog event_type=new_incorporation: ettevõte ilmub sinna päeval, mil ta esimest korda registriandmetes nähtavaks sai, ja event_detail nimetab asutamiskuupäeva.
Seire ei maksa krediite: pakett määrab, mitut ettevõtet sa jälgid (3 prooviperioodil, 25 Starter-paketis, 250 Professional-paketis ja 2 500 Scale-paketis; veebihaagid on kõigis pakettides). Ettevõtte otsing maksab 1 krediidi ja sündmuste päring 2; vead on tasuta. Starter maksab 9,99 € kuus (1 000 krediiti), Professional 29,99 € (10 000 krediiti) ja Scale 99,99 € (50 000 krediiti). 14-päevane prooviperiood sisaldab 500 krediiti: kaart on nõutav, prooviperioodi jooksul tasu ei võeta ning seejärel jätkub Starter (9,99 € kuus), kui sa ei tühista. Vaata hindu.
Contains data from the Estonian e-Business Register (RIK), CC BY 4.0. Prometiam ei ole ametlik registriväljavõte.
Alusta 14-päevast prooviperioodi · API dokumentatsioon
Prooviperiood kestab 14 päeva ja sisaldab 500 krediiti. Kaart on nõutav, prooviperioodi jooksul tasu ei võeta; seejärel jätkub Starter-pakett (9,99 € kuus), kui sa ei tühista.