Di che operatore è quel numero?
Questo strumento cerca l'operatore telefonico dietro un numero: a quale gestore appartiene la numerazione e in quale paese. Va oltre la semplice forma del numero, interrogando dati di rete aggiornati. È una funzione in beta: la stiamo affinando e la copertura può variare da paese a paese, quindi il risultato va preso come indicazione, non come certezza assoluta.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Cosa aggiunge rispetto al formato
Sapere che +39 347 123 4567 è un cellulare italiano valido è una cosa; sapere a quale operatore appartiene la numerazione è un'altra. Questo controllo interroga dati di rete per associare il numero a un gestore e a un paese. Attenzione a un limite reale: in Italia e altrove la portabilità permette di cambiare operatore tenendo lo stesso numero, quindi il gestore "di origine" non sempre coincide con quello attuale.
Funzione in beta: cosa aspettarsi
Questa capacità è in fase beta. Significa che funziona ed è già utilizzabile, ma la stiamo migliorando: la precisione e la copertura cambiano da paese a paese, e per alcune numerazioni potresti ottenere solo il paese senza l'operatore. Lo diciamo apertamente perché tu sappia che, per ora, è uno strumento indicativo. Se un risultato ti sembra sbagliato, scrivici: ci aiuta a perfezionarlo.
Quando è utile
Serve a chi lavora con volumi di numeri e vuole un'idea del gestore o del paese — per stimare i costi di un invio, capire la provenienza di una lista, o arricchire una scheda contatto. Si esegue qui sul sito per una ricerca singola, o via API se vuoi elaborare più numeri. Il numero viene usato solo per la ricerca e poi eliminato.
Casi d'uso
Stimare i costi di una campagna
Prima di un invio a una lista mista, vuoi un'idea di quanti numeri sono su operatori e paesi diversi, così da valutare i costi. La ricerca ti dà un quadro indicativo, tenendo conto che è in beta.
Arricchire una scheda contatto
Nel gestionale aggiungi, accanto al numero di un fornitore estero, il paese riconosciuto: un'informazione in più per sapere con chi hai a che fare prima di chiamare.
Capire la provenienza di una lista
Ricevi una lista di numeri e vuoi verificare che siano davvero italiani come dichiarato. Una ricerca a campione ti dà un'indicazione sul paese di numerazione.
Domande frequenti
L'operatore trovato è sempre quello attuale?
Non sempre. Con la portabilità del numero una persona può cambiare gestore mantenendo lo stesso numero, quindi il risultato indica l'operatore associato alla numerazione, che può non coincidere con quello reale in uso.
Perché è indicata come beta?
Perché la stiamo ancora affinando: la copertura e la precisione variano da paese a paese e per alcuni numeri otterrai solo il paese. Preferiamo dirtelo con onestà piuttosto che promettere una precisione che oggi non è garantita.
Quanto costa?
$0.002 a ricerca, senza abbonamento. Paghi solo le ricerche che fai; per volumi puoi collegare l'API.
Il numero che cerco viene conservato?
No. Serve solo a fare la ricerca al momento, poi viene eliminato. Non teniamo archivi dei numeri che verifichi.
Mi dice il nome o l'intestatario del numero?
No, e non lo faremmo: questo strumento indica l'operatore e il paese della numerazione, mai l'identità della persona. Risalire all'intestatario non è una funzione che offriamo.
Serve solo a controllare il formato?
No, per quello c'è un controllo gratuito nel browser. Questo interroga la rete per l'operatore ed è per questo che si paga a consumo.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/verify/phone-carrier \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"items":["valor-1","valor-2"]}'const res = await fetch("https://api.kit.forhosting.com/verify/phone-carrier", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"items": [
"valor-1",
"valor-2"
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/verify/phone-carrier",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"items": [
"valor-1",
"valor-2"
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/verify/phone-carrier", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"items":["valor-1","valor-2"]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"items":["valor-1","valor-2"]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/verify/phone-carrier", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"items": [
"valor-1",
"valor-2"
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "verify.phone_carrier",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |