Documentazione · Sviluppatori Beta

Radar API

Da un indirizzo IP all'azienda italiana che c'è dietro: nome, P.IVA, settore, fatturato, dipendenti. Una sola chiamata REST, risposta JSON.

Introduzione

L'API di Radar risponde a una domanda: quale azienda si nasconde dietro un indirizzo IP che ha visitato il tuo sito. Incrocia i registri europei RIPE con l'anagrafica delle imprese italiane e, quando riconosce l'azienda, restituisce il profilo completo.

Le aziende sì, le persone no: Radar identifica soggetti giuridici (dato d'impresa, come una visura), mai persone fisiche.

Base URLhttps://api.clientium.it/v1

Beta: l'endpoint pubblico è in fase di apertura. Per ottenere una chiave scrivi a radar@clientium.it.

Autenticazione

Ogni richiesta porta la tua chiave nell'header X-API-Key (oppure come parametro ?api_key=). Le chiavi sono legate al tuo account e ai suoi piani.

curl https://api.clientium.it/v1/health \
  -H "X-API-Key: rdr_la_tua_chiave"

Risposta:

{ "ok": true, "dump": "20260811", "ranges": "766886", "camerale": 1885358 }

Risolvi un IP

GET /v1/resolve?ip=<indirizzo>

Restituisce l'azienda dietro l'IP e, quando disponibile, il profilo camerale. Se l'IP appartiene a un operatore telefonico o a un hosting, Radar lo dichiara invece di indovinare: biz resta 0.

curl "https://api.clientium.it/v1/resolve?ip=93.42.10.7" \
  -H "X-API-Key: rdr_la_tua_chiave"

Risposta (azienda riconosciuta):

{
  "ip": "93.42.10.7",
  "biz": 1,
  "azienda": "Acme Meccanica S.r.l.",
  "piva": "01234560171",
  "citta": "Brescia",
  "paese": "IT",
  "conf": 0.92,
  "src": "ripe_tam",
  "profilo": {
    "settore": "Fabbricazione di parti meccaniche",
    "provincia": "BS",
    "fatturato": "4200000.00",
    "dipendenti": "38",
    "sito": "acmemeccanica.it"
  }
}

Campi principali:

Campo	Tipo	Significato
`biz`	0 / 1	1 = azienda identificata, 0 = non attribuibile (operatore, hosting, IP consumer)
`azienda`	string	Ragione sociale
`piva`	string	Partita IVA
`conf`	0–1	Confidenza del match. Sotto 0,5 il dato è debole
`src`	string	Origine: `ripe_tam`, `ptr_tam`, `ripe`, `asn`, `miss`
`profilo`	object	Dati camerali: settore, provincia, fatturato, dipendenti, sito

Aziende identificate

GET /v1/companies?limit=100

Le aziende che hanno visitato il tuo sito, più recenti prima. La chiave determina il sito.

curl "https://api.clientium.it/v1/companies?limit=50" \
  -H "X-API-Key: rdr_la_tua_chiave"

{ "companies": [
  { "azienda": "Acme Meccanica S.r.l.", "citta": "Brescia",
    "ip": "93.42.10.7", "page": "/prezzi", "visits": 4,
    "first_seen": "2026-08-11", "last_seen": "2026-08-12" }
]}

Webhook

Invece di interrogare, fatti avvisare. Registra un URL e Radar ci manda un POST a ogni nuova azienda identificata: la base per Zapier, Make, n8n o il tuo CRM.

POST /v1/webhooks

curl -X POST https://api.clientium.it/v1/webhooks \
  -H "X-API-Key: rdr_la_tua_chiave" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://tuo-sito.it/hook", "event": "company.identified" }'

Quando scatta l'evento, al tuo URL arriva:

{
  "event": "company.identified",
  "ts": 1786512705,
  "data": { "azienda": "Acme Meccanica S.r.l.", "piva": "01234560171",
    "citta": "Brescia", "page": "/prezzi" }
}

GET /v1/webhooks · DELETE /v1/webhooks?id=<id>

Elenca o rimuove i webhook registrati.

Errori

Codice	Significato
`200`	OK
`201`	Creato (webhook)
`400`	Richiesta malformata (IP o URL mancante)
`401`	Chiave assente o non valida
`404`	Endpoint inesistente

{ "error": "invalid_api_key" }

Piani e limiti

Il numero di aziende identificate al mese segue il piano del tuo account Radar (Free, Pro, Scale). L'accesso all'API e il push automatico su CRM sono inclusi nei piani Scale e Partner. Superata la soglia, la risoluzione continua ma le eccedenze sono contate, mai addebitate a sorpresa.

Domande di integrazione: radar@clientium.it. Vedi anche come funziona Radar e il trattamento dati.