DNS e rete 1 Endpoint 8 Caratteristiche Principali

API per Geolocalizzazione IP

Consulta i dati di rete e di localizzazione approssimativa forniti dal provider per un indirizzo IP, arricchiti da DomScan con il contesto di hosting e segnali di sicurezza circoscritti. I campi disponibili e il livello di dettaglio variano in base all'indirizzo e alla versione IP.

Categoria DNS e rete
Endpoint 1
Caratteristiche Principali 8
Domande Frequenti 4

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

In tempo reale Stato del servizio

Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.

OpenAPI Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

10,000 Quota gratuita

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Cosa ti aiuta a costruire questa API

Usa questa pagina come brief di produzione: endpoint, esempi, forma della risposta e parti del workflow per integrare DomScan nel tuo prodotto.

Workflow di prodotto

Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.

Automazione per analisti

Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.

Dati JSON puliti

Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.

AI e strumenti ops

Alimenta agenti, dashboard, playbook SOAR e CRM tramite OpenAPI, SDK, Postman o MCP.

Workflow di integrazione

Un percorso semplice dalla prima richiesta all’uso ripetibile in produzione.

1
Autentica una volta

Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.

2
Interroga con esempi

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

3
Opera e monitora

Usa codici di stato, costi in crediti e campi di risposta per costruire retry, log e alert.

Kit sviluppatori

Passa da questa pagina a docs leggibili da macchina, raccolte di richieste, SDK o strumenti per agenti.

Mappa di parametri e risposta

Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.

Parametri richiesta

Parametro

ip
Campi risposta

Risposta di esempio

ipdomaingeolocationgeolocation.countrygeolocation.country_namegeolocation.regiongeolocation.region_namegeolocation.citygeolocation.postalgeolocation.latitudegeolocation.longitudegeolocation.timezone
Copertura stati

Codici di stato HTTP

200400401402429500502503504

Endpoint

GET /v1/ip
Crediti: 1Autenticazione: Autenticazione richiesta
ip

Segnali di fiducia prima dell’integrazione

Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.

Stato del servizio Artefatti API

OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.

Chiavi API Accesso protetto

Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.

Quota gratuita Iscriviti Gratuitamente

Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.

Attivo Richiesta di esempio

Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.

Caratteristiche Principali

Geolocalizzazione

Città, regione, paese, codice postale e coordinate forniti dal provider, sempre approssimativi e talvolta incompleti.

Identificazione ISP

Consulta il provider di servizi Internet associato all'indirizzo IP.

Ricerca organizzazione

Consulta l'organizzazione che il provider associa alla rete.

Informazioni ASN

Consulta il numero di sistema autonomo e i dati di rete disponibili.

Contesto di hosting

Usa i dati del provider e le informazioni sugli intervalli cloud, incentrate su IPv4, per valutare il contesto di hosting o data center.

Segnali di sicurezza circoscritti

Consulta il flag proxy del provider, un elenco selezionato di nodi di uscita Tor e indicazioni generali sugli ASN potenzialmente associati a VPN.

Ricerca fuso orario

Consulta il fuso orario indicato per la posizione approssimativa dell'IP, se disponibile.

DNS Inverso

Per IPv4, consulta i risultati PTR e di DNS inverso confermato da risoluzione diretta (FCrDNS), se disponibili.

Richiesta di esempio

GET /v1/ip bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"

Risposta di esempio

200 OK json
{
  "ip": "8.8.8.8",
  "domain": null,
  "geolocation": {
    "country": "US",
    "country_name": "United States",
    "region": null,
    "region_name": null,
    "city": null,
    "postal": null,
    "latitude": null,
    "longitude": null,
    "timezone": null,
    "precision": "country"
  },
  "network": {
    "asn": 15169,
    "asn_name": "AS15169",
    "asn_org": "Google LLC",
    "isp": "Google LLC",
    "connection_type": "hosting"
  },
  "security": {
    "is_proxy": false,
    "is_vpn": false,
    "is_tor": false,
    "is_tor_exit": false,
    "is_datacenter": true,
    "is_cloud": true,
    "cloud_provider": "Google Cloud",
    "threat_score": 0,
    "type_classification": {
      "type": "datacenter",
      "confidence": "high"
    },
    "fcrdns": {
      "ptr": "dns.google",
      "fcrdns_valid": true
    }
  },
  "intelligence_summary": {
    "query_type": "ip",
    "domain_resolved": false,
    "cache_status": "miss",
    "data_source": "cloudflare-intel+enrichment",
    "confidence": "high",
    "confidence_score": 100,
    "asn_present": true,
    "organization_present": true,
    "country_present": true,
    "security_signal_count": 2,
    "risk_flags": [
      "cloud",
      "datacenter"
    ],
    "hosting_category": "cloud"
  },
  "meta": {
    "query_time_ms": 118,
    "cached": false,
    "source": "cloudflare-intel+enrichment"
  }
}

Domande Frequenti

Quanto è accurata la geolocalizzazione?

La geolocalizzazione è fornita dal provider ed è approssimativa. Copertura e livello di dettaglio variano in base all'indirizzo e all'area geografica, quindi non va usata per determinare la posizione fisica precisa di una persona o di un dispositivo.

Posso cercare indirizzi IPv6?

Sì. Il provider principale può restituire dati di base su rete e posizione per IPv6, ma le verifiche PTR/FCrDNS e le informazioni sugli intervalli cloud sono attualmente incentrate su IPv4. Il risultato non è quindi identico a quello di una ricerca IPv4.

Quali segnali di sicurezza sono inclusi?

I risultati possono includere il flag proxy del provider principale, le corrispondenze con un elenco selezionato di nodi di uscita Tor e indicazioni generali sugli ASN potenzialmente associati a VPN. Questi segnali non usano analisi comportamentali e non costituiscono un verdetto completo su proxy o VPN.

I dati sono in tempo reale?

Non necessariamente. I dati del provider principale e gli arricchimenti di DomScan possono rimanere nella cache fino a 24 ore, mentre le fonti esterne seguono i propri tempi di aggiornamento. Non è garantita una cadenza giornaliera fissa.

Strumenti e Risorse Correlati

Codici di stato HTTP

Documentiamo i codici di stato HTTP che il tuo client dovrebbe gestire per distinguere risposte riuscite, problemi di autenticazione, crediti, limiti di richiesta, dati mancanti ed errori upstream.

OK 200

Richiesta riuscita

Richiesta non valida 400

Parametri non validi

Non autorizzato 401

Chiave API o sessione mancante o non valida.

Pagamento richiesto 402

Crediti insufficienti per eseguire questa richiesta.

Troppe richieste 429

Limite di richieste superato

Errore del server 500

Errore interno

Gateway non valido 502

Errore RDAP upstream

Servizio non disponibile 503

Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.

Timeout del gateway 504

La richiesta al servizio a monte è scaduta.

Lookup Indirizzo IP