Debitering
Vad en förfrågan kostar och hur du kan spåra det.
Priser per endpoint och funktion
API:et debiterar i krediter. Varje förfrågan kostar sin endpoints grundpris, plus de funktioner som returnerar data och eventuella tillägg du väljer. Priserna är desamma i varje plan. Din plan avgör vilka funktioner du kan använda.
| Endpoint | Vad | Krediter |
|---|---|---|
| fetch-organization | Företagsprofil med grunddata | 5 |
| fetch-organization | Funktioner, se nästa tabell | 1 till 80 |
| fetch-organization | Tillägg för AI-läge, även utan träff | +20 |
| fetch-organization | Tillägg för Realtid, för varje lyckad live-hämtning | +10 |
| fetch-person | Personprofil, webbresearch ingår (från Plus) | 15 |
| fetch-person |
Funktionen shareholdings, bara när den returnerar data
|
+5 |
| fetch-person |
Funktionen network (Pro, Max), bara när den returnerar data
|
+25 |
| search-organizations | En sida med resultat, även en tom | 1 |
| fetch-document | Ett levererat dokument | 15 |
| signals | En sida Signals eller en enskild signal | 20 |
| signals |
Ämneskatalogen /v1/signals/catalog
|
gratis |
| account, auth | Konto, saldo, förbrukning, nycklar, tokens och webhook-endpoints | gratis |
Funktionerna i fetch-organization begär du en och en. Var och en kostar bara när den returnerar data:
| Funktion | Innehåll | Krediter | Plan |
|---|---|---|---|
| related_persons | Företagsledning | 2 | varje konto |
| shareholders | Delägare (Beta) | 5 | varje konto |
| shareholders_deep | Fördjupade delägardata | 80 | Max |
| ubos | Verkliga huvudmän (UBO, Beta) | 10 | varje konto |
| shareholdings | Innehav (Beta) | 5 | varje konto |
| mergers_and_acquisitions | Fusioner & förvärv (M&A, Beta) | 20 | varje konto |
| network | Företagsnätverk (Beta) | 25 | Pro, Max |
| publications | Historik: registerkungörelserna | 1 | varje konto |
| financial_kpi | Finansiella nyckeltal | 1 | varje konto |
| balance_sheet_accounts | Balansräkning | 3 | varje konto |
| profit_and_loss_account | Resultaträkning | 3 | varje konto |
| annual_financial_statements | Årsbokslut (Markdown) | 5 | varje konto |
| annual_financial_statements__html | Årsbokslut (HTML) | 5 | varje konto |
| insolvency_publications | Insolvenskungörelser | 5 | varje konto |
| news | Nyheter | 10 | varje konto |
| website_content | Webbplatsinnehåll · bara med AI-läget | gratis | varje konto |
Med alla funktioner och båda tilläggen kostar en förfrågan till fetch-organization högst 215 krediter. Denna omfattning ingår i Max.
En bevakning kostar ett fast pris per period på 30 dagar, beroende på kontrollintervallet. Att skapa den och den första baslinjen är gratis.
| Kontrollintervall | Krediter per 30 dagar |
|---|---|
| varje dag | 50 |
| med 3 dagars mellanrum | 40 |
| med 7 dagars mellanrum | 20 |
| med 30 dagars mellanrum | 10 |
| Varje ytterligare lyckad kontroll under perioden | +2 |
Ett intervall mellan dessa steg kostar lika mycket som närmast tätare steg. Mer under account/monitors.
Betala bara för det som returnerar data
En funktion utan data kostar ingenting. Om den returnerar null eller en tom lista betalar du inte för den. Det gäller varje funktion, även insolvency_publications: utan insolvenskungörelser är den gratis.
Grundpriset och tilläggen följer egna regler. Grundpriset betalar du för varje levererad företagsprofil. AI-läget kostar även utan träff. Realtid kostar vid varje lyckad live-hämtning, även om ingenting har ändrats i registret. Mer under Tillägg.
För vissa funktioner spelar specifikt innehåll roll:
shareholdersochshareholders_deepkostar bara när det finns aktuella poster. Enbart en historik är gratis.mergers_and_acquisitionskostar bara med transaktioner, kontrollförhållanden eller rättsliga successioner.networkkostar bara med minst en koppling.newskostar så snart listan innehåller minst en artikel.
fetch-organization utelämnar en funktion som din plan inte omfattar och debiterar den inte.
Med Sök & export, dokument och Signals betalar du för själva förfrågan: en sida med resultat, ett dokument, en sida Signals. En sökning utan resultat och en tom sida Signals debiteras också.
En misslyckad eller avvisad förfrågan kostar ingenting, se Fel.
Tillägg för AI-läge och Realtid
fetch-organization har två tillägg som du slår på per förfrågan.
AI-läge (ai_search=on-default, +20 krediter) hittar företaget även från vag indata och researchar på webben. Det debiteras så snart researchen har körts, även om det inte hittar något företag eller datakällan rapporterar ett fel. Bara när API:et avbryter förfrågan med 408 debiteras det inte.
Realtid (realtime_mode=handelsregister-default, +10 krediter) hämtar de registrerade personerna live från Handelsregister (handelsregistret). Vi debiterar tillägget när live-hämtningen lyckas, oavsett vad den returnerar. Då har _realtime_mode.status värdet success.
Varje annat värde där betyder att live-hämtningen misslyckades. Du får då sparade data och betalar för resten av förfrågan, utan tillägget för Realtid. Om förfrågan tar för lång tid svarar API:et med 408 och debiterar 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
Varje svar anger vad det kostade. I JSON-svar står det i meta, för dokument i headers.
| Var | Betydelse |
|---|---|
| meta.request_credit_cost |
Vad denna förfrågan kostade. För upprepningar med idempotency-nyckel och nästan alla fel är det 0.
|
| meta.credits_remaining | Ditt saldo efter förfrågan. |
| X-Credits-Charged | signals och ett levererat dokument: vad förfrågan kostade, som header. |
| X-Credits-Remaining | Ett levererat dokument: ditt saldo efter förfrågan, som header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Avvisningar vid autentisering (401, 403) och över gränsen (429) kommer oftast utan meta. De kostar aldrig något.
Varje debitering hittar du under Konto › Förbrukning och via API:et på GET /v1/account/usage/transactions, se account.
För få krediter
Innan API:et bearbetar en förfrågan kontrollerar det om ditt saldo täcker den högsta möjliga kostnaden: grundpris, alla begärda funktioner och tilläggen. Om inte svarar API:et med 402 och debiterar ingenting.
Svaret visar detta maximum i meta.request_credit_cost och ditt saldo i meta.credits_remaining. Det belopp som senare debiteras är ofta lägre, eftersom funktioner utan data inte kostar något.
Ett exempel: grunddata med AI-läge och funktionen ubos kräver 35 krediter i förväg. Om ubos inte returnerar några data kostar förfrågan 25 krediter.
signals svarar med Problem Details och koden INSUFFICIENT_CREDITS.
Kreditprenumeration och påfyllningskrediter
Varje nytt konto får 150 startkrediter. De gäller i 30 dagar.
Med en kreditprenumeration (Plus, Pro, Max eller Enterprise) får du krediter varje månad. De gäller till slutet av faktureringsperioden. Om du byter plan tar du med oanvända månadskrediter till den nya perioden. Från Plus kan du använda fetch-person; Pro och Max låser upp ytterligare data.
Påfyllningskrediter köper du en gång, som tillägg. Utan kreditprenumeration gäller de i 30 dagar. Så länge en kreditprenumeration löper förfaller varken påfyllningskrediter eller startkrediter.
Ditt saldo och vad som förfaller när ser du under Konto › Krediter och via API:et på GET /v1/account/credits.
Alla planer och priser finns på prissidan.