Avregning
Hva en forespørsel koster, og hvordan du sporer det.
Priser per endepunkt og funksjon
API-et avregner i kreditter. Hver forespørsel koster grunnprisen for endepunktet, pluss funksjonene som returnerer data, og eventuelle tillegg du velger. Prisene er de samme i hvert abonnement. Abonnementet ditt avgjør hvilke funksjoner du kan bruke.
| Endepunkt | Hva | Kreditter |
|---|---|---|
| fetch-organization | Firmaprofil med grunndataene | 5 |
| fetch-organization | Funksjoner, se neste tabell | 1 til 80 |
| fetch-organization | Tillegg for AI-modus, også uten treff | +20 |
| fetch-organization | Tillegg for Sanntid, for hver vellykket live-henting | +10 |
| fetch-person | Personprofil, nettsøk inkludert (fra Plus) | 15 |
| fetch-person |
Funksjonen shareholdings, bare når den returnerer data
|
+5 |
| fetch-person |
Funksjonen network (Pro, Max), bare når den returnerer data
|
+25 |
| search-organizations | Én side med resultater, også en tom | 1 |
| fetch-document | Ett levert dokument | 15 |
| signals | Én side med Signals eller ett enkelt signal | 20 |
| signals |
Temakatalogen /v1/signals/catalog
|
gratis |
| account, auth | Konto, saldo, forbruk, nøkler, tokens og webhook-endepunkter | gratis |
Funksjonene i fetch-organization ber du om enkeltvis. Hver koster bare når den returnerer data:
| Funksjon | Innhold | Kreditter | Abonnement |
|---|---|---|---|
| related_persons | Ledelse | 2 | hver konto |
| shareholders | Eiere (Beta) | 5 | hver konto |
| shareholders_deep | Dype eierdata | 80 | Max |
| ubos | Reelle rettighetshavere (UBO, Beta) | 10 | hver konto |
| shareholdings | Eierandeler (Beta) | 5 | hver konto |
| mergers_and_acquisitions | Fusjoner og oppkjøp (M&A, Beta) | 20 | hver konto |
| network | Firmanettverk (Beta) | 25 | Pro, Max |
| publications | Historikk: registerkunngjøringene | 1 | hver konto |
| financial_kpi | Økonomiske KPI-er | 1 | hver konto |
| balance_sheet_accounts | Balanse | 3 | hver konto |
| profit_and_loss_account | Resultatregnskap | 3 | hver konto |
| annual_financial_statements | Årsregnskap (Markdown) | 5 | hver konto |
| annual_financial_statements__html | Årsregnskap (HTML) | 5 | hver konto |
| insolvency_publications | Insolvenskunngjøringer | 5 | hver konto |
| news | Nyheter | 10 | hver konto |
| website_content | Innhold fra nettstedet · bare med AI-modus | gratis | hver konto |
Med alle funksjoner og begge tilleggene koster en forespørsel til fetch-organization høyst 215 kreditter. Dette omfanget følger med Max.
En monitor koster en fast pris per periode på 30 dager, avhengig av sjekkintervallet. Opprettelsen og den første baselinen er gratis.
| Sjekkintervall | Kreditter per 30 dager |
|---|---|
| hver dag | 50 |
| hver 3. dag | 40 |
| hver 7. dag | 20 |
| hver 30. dag | 10 |
| Hver ytterligere vellykket sjekk i perioden | +2 |
Et intervall mellom disse trinnene koster like mye som det neste, hyppigere trinnet. Mer under account/monitors.
Betal bare for det som returnerer data
En funksjon uten data koster ingenting. Returnerer den null eller en tom liste, betaler du ikke for den. Det gjelder hver funksjon, også insolvency_publications: uten insolvenskunngjøringer er den gratis.
Grunnprisen og tilleggene følger egne regler. Grunnprisen betaler du for hver levert firmaprofil. AI-modus koster også uten treff. Sanntid koster for hver vellykket live-henting, også når ingenting er endret i registeret. Mer under Tillegg.
For noen funksjoner er bestemt innhold avgjørende:
shareholdersogshareholders_deepkoster bare når det finnes aktuelle oppføringer. Bare historikk er gratis.mergers_and_acquisitionskoster bare med transaksjoner, kontrollforhold eller rettsetterfølgere.networkkoster bare med minst én forbindelse.newskoster så snart listen inneholder minst én artikkel.
fetch-organization utelater en funksjon abonnementet ditt ikke omfatter, og avregner den ikke.
Med Søk & eksport, dokumenter og Signals betaler du for selve forespørselen: én side med resultater, ett dokument, én side med Signals. Et søk uten resultater og en tom side med Signals avregnes også.
En mislykket eller avvist forespørsel koster ingenting, se Feil.
Tillegg for AI-modus og Sanntid
fetch-organization har to tillegg som du slår på per forespørsel.
AI-modus (ai_search=on-default, +20 kreditter) finner firmaet også ut fra vage inndata og undersøker på nettet. Den avregnes så snart researchen har kjørt, også når den ikke finner noe firma eller datakilden melder en feil. Bare når API-et avbryter forespørselen med 408, avregnes den ikke.
Sanntid (realtime_mode=handelsregister-default, +10 kreditter) henter de registrerte personene live fra Handelsregister (handelsregisteret). Vi avregner tillegget når live-hentingen lykkes, uansett hva den returnerer. Da har _realtime_mode.status verdien success.
Enhver annen verdi der betyr at live-hentingen mislyktes. Du får da de lagrede dataene og betaler for resten av forespørselen, uten tillegget for Sanntid. Tar forespørselen for lang tid, svarer API-et med 408 og avregner ingenting.
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}
Kostnader i svaret
Hvert svar forteller deg hva det kostet. I JSON-svar står det i meta, for dokumenter i headere.
| Hvor | Betydning |
|---|---|
| meta.request_credit_cost |
Hva denne forespørselen kostet. For nye forsøk med idempotensnøkkel og nesten alle feil er dette 0.
|
| meta.credits_remaining | Saldoen din etter forespørselen. |
| X-Credits-Charged | signals og et levert dokument: hva forespørselen kostet, som header. |
| X-Credits-Remaining | Et levert dokument: saldoen din etter forespørselen, som header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Avvisninger ved autentisering (401, 403) og over grensen (429) kommer som regel uten meta. De koster aldri noe.
Hver belastning finner du under Konto › Forbruk og via API-et på GET /v1/account/usage/transactions, se account.
Ikke nok kreditter
Før API-et behandler en forespørsel, sjekker det om saldoen din dekker den høyest mulige kostnaden: grunnpris, alle forespurte funksjoner og tilleggene. Gjør den ikke det, svarer API-et med 402 og avregner ingenting.
Svaret viser dette maksimumet i meta.request_credit_cost og saldoen din i meta.credits_remaining. Beløpet som avregnes senere, er ofte lavere, fordi funksjoner uten data ikke koster noe.
Et eksempel: grunndata med AI-modus og funksjonen ubos trenger 35 kreditter på forhånd. Returnerer ubos ingen data, koster forespørselen 25 kreditter.
signals svarer med Problem Details og koden INSUFFICIENT_CREDITS.
Kredittabonnement og påfyllskreditter
Hver ny konto får 150 startkreditter. De gjelder i 30 dager.
Med et kredittabonnement (Plus, Pro, Max eller Enterprise) får du kreditter hver måned. De gjelder til slutten av avregningsperioden. Bytter du abonnement, tar du med ubrukte månedskreditter inn i den nye perioden. Fra Plus kan du bruke fetch-person; Pro og Max låser opp flere data.
Påfyllskreditter kjøper du én gang, i tillegg. Uten kredittabonnement gjelder de i 30 dager. Så lenge et kredittabonnement løper, utløper verken påfyllskreditter eller startkreditter.
Saldoen din og hva som utløper når, ser du under Konto › Kreditter og via API-et på GET /v1/account/credits.
Alle abonnementer og priser står på prissiden.