Afregning
Hvad en forespørgsel koster, og hvordan du kan spore det.
Priser pr. endpoint og feature
API’et afregner i kreditter. Hver forespørgsel koster sit endpoints grundpris plus de features, der returnerer data, og eventuelle tillæg, du vælger. Priserne er de samme i hvert abonnement. Dit abonnement afgør, hvilke features du kan bruge.
| Endpoint | Hvad | Kreditter |
|---|---|---|
| fetch-organization | Virksomhedsprofil med grunddata | 5 |
| fetch-organization | Features, se den næste tabel | 1 til 80 |
| fetch-organization | Tillæg for AI-tilstand, også uden match | +20 |
| fetch-organization | Tillæg for Realtid, for hvert vellykket live-opslag | +10 |
| fetch-person | Personprofil, inkl. webresearch (fra Plus) | 15 |
| fetch-person |
Featuren shareholdings, kun når den returnerer data
|
+5 |
| fetch-person |
Featuren network (Pro, Max), kun når den returnerer data
|
+25 |
| search-organizations | Én side med resultater, også en tom | 1 |
| fetch-document | Ét leveret dokument | 15 |
| signals | Én side med Signals eller et enkelt signal | 20 |
| signals |
Emnekataloget /v1/signals/catalog
|
gratis |
| account, auth | Konto, saldo, forbrug, nøgler, tokens og webhook-endpoints | gratis |
Features i fetch-organization anmoder du om enkeltvis. Hver koster kun, når den returnerer data:
| Feature | Indhold | Kreditter | Abonnement |
|---|---|---|---|
| related_persons | Direktion | 2 | enhver konto |
| shareholders | Ejere (Beta) | 5 | enhver konto |
| shareholders_deep | Dybe ejeroplysninger | 80 | Max |
| ubos | Reelle ejere (UBO, Beta) | 10 | enhver konto |
| shareholdings | Kapitalandele (Beta) | 5 | enhver konto |
| mergers_and_acquisitions | Fusioner & opkøb (M&A, Beta) | 20 | enhver konto |
| network | Virksomhedsnetværk (Beta) | 25 | Pro, Max |
| publications | Historik: registerbekendtgørelserne | 1 | enhver konto |
| financial_kpi | Finansielle nøgletal | 1 | enhver konto |
| balance_sheet_accounts | Balance | 3 | enhver konto |
| profit_and_loss_account | Resultatopgørelse | 3 | enhver konto |
| annual_financial_statements | Årsregnskaber (Markdown) | 5 | enhver konto |
| annual_financial_statements__html | Årsregnskaber (HTML) | 5 | enhver konto |
| insolvency_publications | Insolvensbekendtgørelser | 5 | enhver konto |
| news | Nyheder | 10 | enhver konto |
| website_content | Websiteindhold · kun med AI-tilstand | gratis | enhver konto |
Med alle features og begge tillæg koster en forespørgsel til fetch-organization højst 215 kreditter. Dette omfang følger med Max.
En monitor koster en fast pris pr. periode på 30 dage, afhængigt af tjekintervallet. Oprettelsen og den første baseline er gratis.
| Tjekinterval | Kreditter pr. 30 dage |
|---|---|
| hver dag | 50 |
| hver 3. dag | 40 |
| hver 7. dag | 20 |
| hver 30. dag | 10 |
| Hvert yderligere vellykket tjek i perioden | +2 |
Et interval mellem disse trin koster lige så meget som det næste hyppigere trin. Mere under account/monitors.
Betal kun for det, der returnerer data
En feature uden data koster intet. Returnerer den null eller en tom liste, betaler du ikke for den. Det gælder hver feature, også insolvency_publications: uden insolvensbekendtgørelser er den gratis.
Grundprisen og tillæggene følger deres egne regler. Grundprisen betaler du for hver leveret virksomhedsprofil. AI-tilstand koster også uden match. Realtid koster for hvert vellykket live-opslag, også hvis intet har ændret sig i registret. Mere under Tillæg.
For nogle features er bestemt indhold afgørende:
shareholdersogshareholders_deepkoster kun, når der er nuværende poster. En historik alene er gratis.mergers_and_acquisitionskoster kun med transaktioner, beherskelsesforhold eller retlige successioner.networkkoster kun med mindst én forbindelse.newskoster, så snart listen indeholder mindst én artikel.
fetch-organization udelader en feature, som dit abonnement ikke omfatter, og afregner den ikke.
Ved Søgning & eksport, dokumenter og Signals betaler du for selve forespørgslen: én side med resultater, ét dokument, én side med Signals. En søgning uden resultater og en tom side med Signals afregnes også.
En mislykket eller afvist forespørgsel koster intet, se Fejl.
Tillæg for AI-tilstand og Realtid
fetch-organization har to tillæg, som du slår til pr. forespørgsel.
AI-tilstand (ai_search=on-default, +20 kreditter) finder virksomheden også ud fra vagt input og researcher på nettet. Den afregnes, så snart researchen er kørt, også hvis den ikke finder nogen virksomhed, eller datakilden melder en fejl. Kun når API’et afbryder forespørgslen med 408, afregnes den ikke.
Realtid (realtime_mode=handelsregister-default, +10 kreditter) henter de registrerede personer live fra Handelsregister (det tyske handelsregister). Vi afregner tillægget, når live-opslaget lykkes, uanset hvad det returnerer. Så har _realtime_mode.status værdien success.
Enhver anden værdi dér betyder, at live-opslaget fejlede. Du får så de gemte data og betaler for resten af forespørgslen, uden tillægget for Realtid. Tager forespørgslen for lang tid, svarer API’et med 408 og afregner intet.
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
Omkostninger i svaret
Hvert svar fortæller dig, hvad det kostede. I JSON-svar står det i meta, for dokumenter i headers.
| Hvor | Betydning |
|---|---|
| meta.request_credit_cost |
Hvad denne forespørgsel kostede. Ved genforsøg med en idempotency-nøgle og næsten alle fejl er det 0.
|
| meta.credits_remaining | Din saldo efter forespørgslen. |
| X-Credits-Charged | signals og et leveret dokument: hvad forespørgslen kostede, som header. |
| X-Credits-Remaining | Et leveret dokument: din saldo efter forespørgslen, som header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Afvisninger ved autentificering (401, 403) og over grænsen (429) kommer som regel uden meta. De koster aldrig noget.
Hver afregning finder du under Konto › Forbrug og via API’et på GET /v1/account/usage/transactions, se account.
Ikke nok kreditter
Før API’et behandler en forespørgsel, tjekker det, om din saldo dækker de højest mulige omkostninger: grundpris, alle ønskede features og tillæggene. Gør den ikke det, svarer API’et med 402 og afregner intet.
Svaret viser dette maksimum i meta.request_credit_cost og din saldo i meta.credits_remaining. Det beløb, der afregnes senere, er ofte lavere, fordi features uden data ikke koster noget.
Et eksempel: grunddata med AI-tilstand og featuren ubos kræver 35 kreditter på forhånd. Returnerer ubos ingen data, koster forespørgslen 25 kreditter.
signals svarer med Problem Details og koden INSUFFICIENT_CREDITS.
Kreditabonnement og optankningskreditter
Hver ny konto får 150 startkreditter. De er gyldige i 30 dage.
Med et kreditabonnement (Plus, Pro, Max eller Enterprise) får du kreditter hver måned. De er gyldige til udgangen af afregningsperioden. Skifter du abonnement, tager du ubrugte månedlige kreditter med ind i den nye periode. Fra Plus kan du bruge fetch-person; Pro og Max låser op for yderligere data.
Optankningskreditter køber du én gang, oveni. Uden kreditabonnement er de gyldige i 30 dage. Så længe et kreditabonnement løber, udløber hverken optankningskreditter eller startkreditter.
Din saldo, og hvad der udløber hvornår, ser du under Konto › Kreditter og via API’et på GET /v1/account/credits.
Alle abonnementer og priser står på prissiden.