Cerca indirizzi IP in blocchi
Invia un elenco di indirizzi IP a un unico endpoint e ricevi un elenco corrispondente di risultati di localizzazione. L'API di ricerca IP in blocco di Watch-IP accetta fino a 100 indirizzi IPv4 e IPv6 per richiesta per flussi di lavoro di arricchimento backend. Mantieni la tua chiave segreta sul server, elabora la risposta nell'ordine di input e gestisci i record mancanti senza perdere il collegamento con i tuoi dati originali.
Una richiesta, fino a 100 indirizzi
Usa POST /v1/lookup con un oggetto JSON contenente un array ips. Ogni blocco accettato contiene almeno un indirizzo e al massimo 100, e puoi mescolare indirizzi IPv4 e IPv6 validi nello stesso elenco. La risposta racchiude i risultati di ricerca ordinati in un array results; ogni risultato usa la struttura della ricerca a IP singolo, inclusi found e i campi di localizzazione nullable.
Mantieni i risultati allineati con i tuoi record di origine
Per un blocco riuscito, l'API restituisce un risultato per ogni indirizzo di input nello stesso ordine. Mantieni i tuoi identificatori di record insieme all'elenco inviato così puoi ricollegare i risultati alle tue righe originali. Quando un record non viene trovato, conserva la riga e contrassegna la posizione come non disponibile; quando manca solo un campo, mantieni il resto del risultato. Non sostituire le coordinate mancanti con zero, il che trasformerebbe un'assenza di dati in una posizione sulla mappa fuorviante.
Convalida prima di inviare
Un elenco vuoto, un elenco più grande di 100 indirizzi o un IP malformato produce un errore di richiesta — un indirizzo malformato rifiuta l'intero blocco anziché produrre un risultato di successo parziale per gli input rimanenti. Convalida l'input e suddividi gli elenchi più lunghi in blocchi prima di inviarli, e tieni un registro dei blocchi completati così un nuovo tentativo non ripete accidentalmente un intero job.
Capisci cosa cambia il raggruppamento in blocco
Il raggruppamento in blocco riduce il numero di richieste HTTP necessarie per inviare un elenco. Non cambia la fonte dei dati, non aggiunge campi di sicurezza e non trasforma 100 ricerche in un'unica unità di utilizzo — l'utilizzo di ricerca viene registrato per IP inviato sulle richieste accettate, quindi la scelta del piano dovrebbe tenere conto sia del volume totale di ricerca sia della frequenza delle richieste. Il limite di frequenza al minuto conta le chiamate HTTP, non gli elementi: un batch fino a 100 IP o indirizzi email conta come una sola richiesta, mentre ogni elemento continua a contare separatamente nel limite mensile di richieste.
Struttura di richiesta e risposta
- ips
- Corpo della richiesta: un array JSON di 1–100 indirizzi IPv4 o IPv6.
- results
- Risposta: un array ordinato con una voce per ogni indirizzo di input, nello stesso ordine inviato.
- results[].found, results[].country, ...
- Ogni risultato usa la stessa struttura e nullability della risposta di ricerca a IP singolo — consulta la pagina del prodotto di ricerca IP.
Invia una richiesta in blocco
cURL — POST /v1/lookup
curl --fail-with-body \
'https://api.watch-ip.com/v1/lookup' \
--header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}" \
--header 'Content-Type: application/json' \
--data '{"ips":["8.8.8.8","2001:4860:4860::8888"]}'Questi indirizzi dimostrativi non implicano particolari valori di posizione attuali. Imposta prima WATCH_IP_SECRET_KEY nell'ambiente del tuo server.
Domande frequenti
Quanti indirizzi IP entrano in un blocco?
Il massimo attuale è 100. Suddividi gli elenchi più lunghi in richieste che contengono ciascuna 1–100 indirizzi.
Un blocco può contenere sia IPv4 che IPv6?
Sì. Ogni indirizzo deve essere valido, e la copertura del database può differire per indirizzo.
I risultati vengono restituiti nell'ordine di input?
Sì. Un blocco accettato e riuscito restituisce un risultato per ogni indirizzo di input nello stesso ordine.
Cosa succede se un IP è malformato?
L'intera richiesta viene rifiutata. Convalida il tuo input prima di inviarlo — questo endpoint non fornisce un successo parziale per un input malformato.
Un blocco viene fatturato come un'unica ricerca?
No. L'utilizzo viene misurato per IP. Consulta il listino prezzi di ricerca attuale e gli esempi di fatturazione verificati prima di stimare il costo di un job di grandi dimensioni.
Posso caricare un file CSV?
L'endpoint documentato accetta un array JSON di indirizzi. La tua applicazione può leggere il proprio CSV e inviare blocchi; un'interfaccia di caricamento CSV ospitata non fa parte di questa API.
La ricerca in blocco include controlli VPN o Tor?
No. L'attuale risposta in blocco è il risultato di localizzazione del database di geolocalizzazione di terze parti. Gli indicatori di sicurezza della geolocalizzazione del visitatore sono una funzionalità separata non presente nelle risposte di ricerca.