Cerca un indirizzo IP dal tuo backend

Risolvi un indirizzo IP fornito in dati disponibili di paese, area geografica, città e coordinate approssimative. L'API di ricerca IP di Watch-IP accetta input IPv4 e IPv6 e restituisce un risultato JSON basato su un database di geolocalizzazione IP di terze parti. Usa una chiave API segreta sul tuo server e costruisci la tua applicazione attorno a corrispondenze esplicite, record mancanti e campi di localizzazione nullable.

Visualizza i piani di ricerca Discuti l'accesso alla ricerca →

Fornisci l'indirizzo che vuoi risolvere

Chiama GET /v1/lookup/{ip} con un indirizzo IP raccolto dalla tua applicazione, autenticato con Authorization: Bearer e una chiave segreta. La ricerca risolve l'indirizzo nell'URL anziché la connessione usata per effettuare la richiesta, il che la rende adatta a flussi di lavoro backend che già contengono indirizzi IP, inclusi reportistica e arricchimento regionale. Verifica come la tua applicazione ottiene l'IP di un utente finale prima di affidarti agli header inoltrati; fidati solo del percorso proxy che controlli. Per un'integrazione ordinaria dei visitatori di un sito web, l'endpoint di geolocalizzazione da browser offre un percorso diverso con una chiave pubblicabile e arricchimento regionale.

Passa da un indirizzo a un blocco

Se il tuo flusso di lavoro contiene diversi indirizzi IP, l'endpoint in blocco ne accetta fino a 100 in un'unica richiesta e restituisce i risultati nello stesso ordine. Usa la stessa struttura di risultato della ricerca e lo stesso modello di autenticazione lato server con chiave segreta. Il raggruppamento in blocco cambia il modo in cui invii le richieste — l'utilizzo di ricerca viene comunque misurato per IP, quindi un blocco non è un'unica unità di utilizzo di ricerca.

Costruisci attorno a dati approssimativi

Un IP può rappresentare un gateway condiviso, una rete di hosting, un'uscita VPN o una connessione di un operatore mobile. I record di localizzazione possono essere incompleti o differire tra i fornitori di dati. Usa la ricerca come contesto per l'indirizzo che hai fornito, non come prova della residenza o dell'identità di una persona.

Campi della risposta

ip: L'indirizzo di input associato a questo risultato.
found: Se è stato trovato un record corrispondente nel database. False può anche significare che il database non è disponibile o non è stato caricato — non dimostra che l'indirizzo non abbia dati di localizzazione.
country, continent: Codici di paese e continente, quando disponibili.
region: Un identificatore di suddivisione dalla mappatura attuale, non sempre un nome di regione completo.
city, latitude, longitude: Città e coordinate approssimative, quando disponibili nel database di origine.
postalCode, timezone: Non popolati dall'attuale database di origine — sempre null.

Effettua una richiesta lato server

cURL — GET /v1/lookup/{ip}

curl --fail-with-body \
  'https://api.watch-ip.com/v1/lookup/8.8.8.8' \
  --header "Authorization: Bearer ${WATCH_IP_SECRET_KEY}"

Imposta prima WATCH_IP_SECRET_KEY nell'ambiente del tuo server. 8.8.8.8 è un indirizzo di esempio sintatticamente valido; questo snippet non promette un particolare paese, città o risposta per esso.

Domande frequenti

Posso usare questa API per cercare l'indirizzo IP di qualcun altro?

L'endpoint accetta un indirizzo IP fornito e restituisce i dati di localizzazione disponibili nel database, non il nome, l'indirizzo esatto o l'identità di una persona. Usa solo dati che sei autorizzato a trattare.

Supporta IPv6?

L'endpoint convalida input IPv4 e IPv6. Un indirizzo valido può comunque mancare di un record nel database o di alcuni campi di localizzazione.

La ricerca include fuso orario, ASN o rilevamento VPN?

No. L'attuale risposta di ricerca non include ASN o indicatori di sicurezza, e la sua fonte, un database di terze parti, non popola i campi fuso orario o CAP. Valuta separatamente la geolocalizzazione del visitatore se il suo modello basato sul client in connessione si adatta alla tua applicazione.

Posso inviare la richiesta da JavaScript nel browser?

No — non esporre mai un segreto di ricerca nel codice del browser. Effettua le chiamate di ricerca dal tuo backend e usa l'endpoint visitatore con una chiave pubblicabile per la geolocalizzazione diretta da browser.

È incluso con una chiave visitatore gratuita?

No. La ricerca usa una chiave segreta e una famiglia di piani separate; il piano visitatore gratuito non concede l'accesso alla ricerca lato server.

Cosa significa found: false?

La ricerca non ha restituito un record corrispondente. Nell'implementazione attuale, questo può accadere anche quando il database non è disponibile o non è stato caricato, quindi mostra "Posizione non disponibile" e tieni questo esito separato da input non validi, errori di autenticazione ed errori di limite di frequenza.