Rozliczanie
Ile kosztuje zapytanie i jak to prześledzisz.
Ceny według endpointu i feature
API rozlicza w kredytach. Każde zapytanie kosztuje cenę bazową swojego endpointu plus features, które zwracają dane, i ewentualne wybrane dopłaty. Ceny są takie same w każdym planie. Twój plan decyduje, z których features możesz korzystać.
| Endpoint | Co | Kredyty |
|---|---|---|
| fetch-organization | Profil firmy z danymi podstawowymi | 5 |
| fetch-organization | Features, zobacz następną tabelę | od 1 do 80 |
| fetch-organization | Dopłata za tryb AI, także bez trafienia | +20 |
| fetch-organization | Dopłata za tryb czasu rzeczywistego, przy każdym udanym pobraniu na żywo | +10 |
| fetch-person | Profil osoby, z wyszukiwaniem w sieci (od Plus) | 15 |
| fetch-person |
Feature shareholdings, tylko gdy zwraca dane
|
+5 |
| fetch-person |
Feature network (Pro, Max), tylko gdy zwraca dane
|
+25 |
| search-organizations | Jedna strona wyników, także pusta | 1 |
| fetch-document | Jeden dostarczony dokument | 15 |
| signals | Jedna strona Signals albo pojedynczy sygnał | 20 |
| signals |
Katalog tematów /v1/signals/catalog
|
bezpłatnie |
| account, auth | Konto, saldo, użycie, klucze, tokeny i endpointy webhooków | bezpłatnie |
Features w fetch-organization zamawiasz pojedynczo. Każdy kosztuje tylko wtedy, gdy zwraca dane:
| Feature | Zawartość | Kredyty | Plan |
|---|---|---|---|
| related_persons | Zarząd | 2 | każde konto |
| shareholders | Wspólnicy (Beta) | 5 | każde konto |
| shareholders_deep | Szczegółowe dane wspólników | 80 | Max |
| ubos | Beneficjenci rzeczywiści (UBO, Beta) | 10 | każde konto |
| shareholdings | Udziały (Beta) | 5 | każde konto |
| mergers_and_acquisitions | Fuzje i przejęcia (M&A, Beta) | 20 | każde konto |
| network | Sieć powiązań firmy (Beta) | 25 | Pro, Max |
| publications | Historia: obwieszczenia rejestrowe | 1 | każde konto |
| financial_kpi | Wskaźniki finansowe | 1 | każde konto |
| balance_sheet_accounts | Bilans | 3 | każde konto |
| profit_and_loss_account | Rachunek zysków i strat | 3 | każde konto |
| annual_financial_statements | Roczne sprawozdania finansowe (Markdown) | 5 | każde konto |
| annual_financial_statements__html | Roczne sprawozdania finansowe (HTML) | 5 | każde konto |
| insolvency_publications | Obwieszczenia upadłościowe | 5 | każde konto |
| news | Wiadomości | 10 | każde konto |
| website_content | Treść strony internetowej · tylko z trybem AI | bezpłatnie | każde konto |
Ze wszystkimi features i obiema dopłatami zapytanie do fetch-organization kosztuje najwyżej 215 kredytów. Taki zakres jest dostępny w Max.
Monitor kosztuje stałą cenę za okres 30 dni, zależnie od częstotliwości sprawdzania. Utworzenie i pierwszy stan bazowy są bezpłatne.
| Częstotliwość sprawdzania | Kredyty za 30 dni |
|---|---|
| codziennie | 50 |
| co 3 dni | 40 |
| co 7 dni | 20 |
| co 30 dni | 10 |
| Każde kolejne udane sprawdzenie w okresie | +2 |
Częstotliwość między tymi stopniami kosztuje tyle co najbliższy częstszy stopień. Więcej w account/monitors.
Płacisz tylko za to, co zwraca dane
Feature bez danych nic nie kosztuje. Jeśli zwraca null lub pustą listę, nie płacisz za niego. Dotyczy to każdego feature, także insolvency_publications: bez obwieszczeń upadłościowych jest bezpłatny.
Cena bazowa i dopłaty mają własne zasady. Cenę bazową płacisz za każdy dostarczony profil firmy. Tryb AI kosztuje także bez trafienia. Tryb czasu rzeczywistego kosztuje przy każdym udanym pobraniu na żywo, nawet jeśli w rejestrze nic się nie zmieniło. Więcej w Dopłatach.
Przy niektórych features liczy się konkretna zawartość:
shareholdersishareholders_deepkosztują tylko wtedy, gdy są bieżące wpisy. Sama historia jest bezpłatna.mergers_and_acquisitionskosztuje tylko przy transakcjach, stosunkach dominacji lub następstwie prawnym.networkkosztuje tylko przy co najmniej jednym powiązaniu.newskosztuje, gdy tylko lista zawiera co najmniej jeden artykuł.
fetch-organization pomija feature, którego nie obejmuje twój plan, i go nie nalicza.
W Wyszukiwaniu i eksporcie, dokumentach i Signals płacisz za samo zapytanie: jedną stronę wyników, jeden dokument, jedną stronę Signals. Wyszukiwanie bez wyników i pusta strona Signals też są naliczane.
Nieudane lub odrzucone zapytanie nic nie kosztuje, zobacz Błędy.
Dopłaty za tryb AI i tryb czasu rzeczywistego
fetch-organization ma dwie dopłaty, które włączasz dla każdego zapytania.
Tryb AI (ai_search=on-default, +20 kredytów) znajduje firmę nawet z nieprecyzyjnych danych i wyszukuje w sieci. Jest naliczany, gdy tylko wyszukiwanie się wykona, nawet jeśli nie znajdzie firmy lub źródło danych zgłosi błąd. Nie jest naliczany tylko wtedy, gdy API przerwie zapytanie z 408.
Tryb czasu rzeczywistego (realtime_mode=handelsregister-default, +10 kredytów) pobiera wpisane osoby na żywo z Handelsregister (rejestr handlowy). Dopłatę naliczamy, gdy pobranie na żywo się uda, niezależnie od tego, co zwróci. Wtedy _realtime_mode.status ma wartość success.
Każda inna wartość oznacza, że pobranie na żywo się nie udało. Dostajesz wtedy zapisane dane i płacisz za resztę zapytania, bez dopłaty za tryb czasu rzeczywistego. Jeśli zapytanie trwa za długo, API odpowiada 408 i nic nie nalicza.
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}
Koszty w odpowiedzi
Każda odpowiedź mówi, ile kosztowała. W odpowiedziach JSON jest to w meta, przy dokumentach w nagłówkach.
| Gdzie | Znaczenie |
|---|---|
| meta.request_credit_cost |
Ile kosztowało to zapytanie. Przy ponowieniach z kluczem idempotencji i prawie wszystkich błędach to 0.
|
| meta.credits_remaining | Twoje saldo po zapytaniu. |
| X-Credits-Charged | signals i dostarczony dokument: ile kosztowało zapytanie, jako nagłówek. |
| X-Credits-Remaining | Dostarczony dokument: twoje saldo po zapytaniu, jako nagłówek. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
Odrzucenia przy uwierzytelnianiu (401, 403) i ponad limit (429) przychodzą zwykle bez meta. Nigdy nic nie kosztują.
Każde naliczenie znajdziesz w Konto › Użycie i przez API pod GET /v1/account/usage/transactions, zobacz account.
Za mało kredytów
Zanim API przetworzy zapytanie, sprawdza, czy twoje saldo pokrywa najwyższy możliwy koszt: cenę bazową, wszystkie zamówione features i dopłaty. Jeśli nie, API odpowiada 402 i nic nie nalicza.
Odpowiedź pokazuje to maksimum w meta.request_credit_cost i twoje saldo w meta.credits_remaining. Kwota naliczona później jest często niższa, bo features bez danych nic nie kosztują.
Przykład: dane podstawowe z trybem AI i feature ubos wymagają z góry 35 kredytów. Jeśli ubos nie zwróci danych, zapytanie kosztuje 25 kredytów.
signals odpowiada przez Problem Details z kodem INSUFFICIENT_CREDITS.
Subskrypcja kredytów i doładowania
Każde nowe konto dostaje 150 kredytów startowych. Są ważne przez 30 dni.
Z subskrypcją kredytów (Plus, Pro, Max lub Enterprise) dostajesz kredyty co miesiąc. Są ważne do końca okresu rozliczeniowego. Jeśli zmienisz plan, niewykorzystane kredyty miesięczne przechodzą na nowy okres. Od Plus możesz korzystać z fetch-person; Pro i Max odblokowują dodatkowe dane.
Doładowanie kredytów kupujesz jednorazowo, dodatkowo. Bez subskrypcji kredytów kredyty z doładowań są ważne przez 30 dni. Dopóki trwa subskrypcja kredytów, nie wygasają ani kredyty z doładowań, ani kredyty startowe.
Saldo i to, co kiedy wygasa, widzisz w Konto › Kredyty i przez API pod GET /v1/account/credits.
Wszystkie plany i ceny są na stronie z cenami.