Fatturazione
Quanto costa una richiesta e come puoi verificarlo.
Prezzi per endpoint e feature
L’API addebita in crediti. Ogni richiesta costa il prezzo base del suo endpoint, più le feature che restituiscono dati e gli eventuali supplementi che scegli. I prezzi sono gli stessi in ogni piano. Il tuo piano decide quali feature puoi usare.
| Endpoint | Cosa | Crediti |
|---|---|---|
| fetch-organization | Profilo aziendale con i dati di base | 5 |
| fetch-organization | Feature, vedi la tabella successiva | da 1 a 80 |
| fetch-organization | Supplemento Modalità AI, anche senza risultato | +20 |
| fetch-organization | Supplemento Tempo reale, per ogni recupero in diretta riuscito | +10 |
| fetch-person | Profilo persona, ricerca web inclusa (da Plus) | 15 |
| fetch-person |
Feature shareholdings, solo se restituisce dati
|
+5 |
| fetch-person |
Feature network (Pro, Max), solo se restituisce dati
|
+25 |
| search-organizations | Una pagina di risultati, anche vuota | 1 |
| fetch-document | Un documento consegnato | 15 |
| signals | Una pagina di Signals o un singolo segnale | 20 |
| signals |
Il catalogo dei temi /v1/signals/catalog
|
gratis |
| account, auth | Account, saldo, consumo, chiavi, token ed endpoint webhook | gratis |
Le feature di fetch-organization le richiedi una per una. Ciascuna costa solo se restituisce dati:
| Feature | Contenuto | Crediti | Piano |
|---|---|---|---|
| related_persons | Amministrazione | 2 | ogni account |
| shareholders | Soci (Beta) | 5 | ogni account |
| shareholders_deep | Soci approfonditi | 80 | Max |
| ubos | Titolari effettivi (UBO, Beta) | 10 | ogni account |
| shareholdings | Partecipazioni (Beta) | 5 | ogni account |
| mergers_and_acquisitions | Fusioni e acquisizioni (M&A, Beta) | 20 | ogni account |
| network | Rete aziendale (Beta) | 25 | Pro, Max |
| publications | Cronologia: le pubblicazioni del registro | 1 | ogni account |
| financial_kpi | KPI finanziari | 1 | ogni account |
| balance_sheet_accounts | Stato patrimoniale | 3 | ogni account |
| profit_and_loss_account | Conto economico | 3 | ogni account |
| annual_financial_statements | Bilanci d’esercizio (Markdown) | 5 | ogni account |
| annual_financial_statements__html | Bilanci d’esercizio (HTML) | 5 | ogni account |
| insolvency_publications | Pubblicazioni sulle insolvenze | 5 | ogni account |
| news | Notizie | 10 | ogni account |
| website_content | Contenuto del sito web · solo con la Modalità AI | gratis | ogni account |
Con tutte le feature ed entrambi i supplementi, una richiesta a fetch-organization costa al massimo 215 crediti. Questa portata è inclusa in Max.
Un monitor costa un prezzo fisso per periodo di 30 giorni, a seconda dell’intervallo di controllo. La creazione e la prima baseline sono gratuite.
| Intervallo di controllo | Crediti per 30 giorni |
|---|---|
| ogni giorno | 50 |
| ogni 3 giorni | 40 |
| ogni 7 giorni | 20 |
| ogni 30 giorni | 10 |
| Ogni ulteriore controllo riuscito nel periodo | +2 |
Un intervallo tra questi gradini costa quanto il gradino successivo più frequente. Maggiori dettagli in account/monitors.
Paghi solo ciò che restituisce dati
Una feature senza dati non costa nulla. Se restituisce null o una lista vuota, non la paghi. Vale per ogni feature, compresa insolvency_publications: senza pubblicazioni sulle insolvenze è gratuita.
Il prezzo base e i supplementi seguono regole proprie. Il prezzo base lo paghi per ogni profilo aziendale consegnato. La Modalità AI costa anche senza risultato. Tempo reale costa per ogni recupero in diretta riuscito, anche se nel registro non è cambiato nulla. Maggiori dettagli in Supplementi.
Per alcune feature conta un contenuto specifico:
shareholderseshareholders_deepcostano solo se ci sono voci attuali. Il solo storico è gratuito.mergers_and_acquisitionscosta solo con transazioni, rapporti di controllo o successioni giuridiche.networkcosta solo con almeno un collegamento.newscosta non appena la lista contiene almeno un articolo.
fetch-organization omette una feature non inclusa nel tuo piano e non la addebita.
Con Ricerca & Export, documenti e Signals paghi la richiesta stessa: una pagina di risultati, un documento, una pagina di Signals. Anche una ricerca senza risultati e una pagina vuota di Signals vengono addebitate.
Una richiesta non riuscita o rifiutata non costa nulla, vedi Errori.
Supplementi per Modalità AI e Tempo reale
fetch-organization ha due supplementi che attivi per singola richiesta.
Modalità AI (ai_search=on-default, +20 crediti) trova l’azienda anche da input vaghi e fa ricerche sul web. Viene addebitata non appena la ricerca è stata eseguita, anche se non trova alcuna azienda o la fonte dei dati segnala un errore. Solo quando l’API interrompe la richiesta con 408 non viene addebitata.
Tempo reale (realtime_mode=handelsregister-default, +10 crediti) recupera in diretta le persone iscritte dall’Handelsregister (registro delle imprese). Addebitiamo il supplemento quando il recupero in diretta riesce, indipendentemente da ciò che restituisce. Allora _realtime_mode.status ha il valore success.
Qualsiasi altro valore lì significa che il recupero in diretta è fallito. Ricevi allora i dati salvati e paghi il resto della richiesta, senza il supplemento Tempo reale. Se la richiesta dura troppo, l’API risponde con 408 e non addebita nulla.
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}
Costi nella risposta
Ogni risposta ti dice quanto è costata. Nelle risposte JSON è in meta, per i documenti negli header.
| Dove | Significato |
|---|---|
| meta.request_credit_cost |
Quanto è costata questa richiesta. Per i nuovi tentativi con un idempotency key e quasi tutti gli errori è 0.
|
| meta.credits_remaining | Il tuo saldo dopo la richiesta. |
| X-Credits-Charged | signals e un documento consegnato: quanto è costata la richiesta, come header. |
| X-Credits-Remaining | Un documento consegnato: il tuo saldo dopo la richiesta, come header. |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
I rifiuti in fase di autenticazione (401, 403) e oltre il limite (429) arrivano di solito senza meta. Non costano mai nulla.
Ogni addebito lo trovi in Account › Utilizzo e tramite l’API in GET /v1/account/usage/transactions, vedi account.
Crediti insufficienti
Prima di elaborare una richiesta, l’API controlla se il tuo saldo copre il costo più alto possibile: prezzo base, tutte le feature richieste e i supplementi. Se non lo copre, risponde con 402 e non addebita nulla.
La risposta indica questo massimo in meta.request_credit_cost e il tuo saldo in meta.credits_remaining. L’importo addebitato poi è spesso più basso, perché le feature senza dati non costano nulla.
Un esempio: dati di base con Modalità AI e la feature ubos richiedono in anticipo 35 crediti. Se ubos non restituisce dati, la richiesta costa 25 crediti.
signals risponde con Problem Details e il codice INSUFFICIENT_CREDITS.
Abbonamento a crediti e crediti di ricarica
Ogni nuovo account riceve 150 crediti iniziali. Valgono 30 giorni.
Con un abbonamento a crediti (Plus, Pro, Max o Enterprise) ricevi crediti ogni mese. Valgono fino alla fine del periodo di fatturazione. Se cambi piano, porti i crediti mensili non usati nel nuovo periodo. Da Plus puoi usare fetch-person; Pro e Max sbloccano dati aggiuntivi.
I crediti di ricarica li acquisti una tantum, in aggiunta. Senza abbonamento a crediti valgono 30 giorni. Finché un abbonamento a crediti è attivo, non scadono né i crediti di ricarica né i crediti iniziali.
Il tuo saldo e cosa scade quando lo vedi in Account › Crediti e tramite l’API in GET /v1/account/credits.
Tutti i piani e i prezzi sono nella pagina prezzi.