Controlla lo stato del servizio in tempo reale e le risposte di errore documentate prima dell’integrazione.
Segnali di fiducia prima dell’integrazione
Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.
OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.
Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.
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.
Integra controlli dominio, intelligence DNS, segnali di rischio o arricchimento in onboarding, ricerca e strumenti interni.
Sostituisci lookup manuali ripetuti con job pianificati, alert e passaggi di indagine riproducibili.
Usa campi prevedibili, codici di stato documentati e costi in crediti invece di fare scraping di pagine provider.
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.
Invia la tua chiave API con l’header documentato e mantieni richieste coerenti tra servizi.
Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.
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.
Genera client o ispeziona ogni forma di richiesta e risposta.
Collezione PostmanImporta richieste pronte per test manuali e handoff al team.
SDK e CLIUsa pacchetti mantenuti e workflow da riga di comando invece di scrivere boilerplate.
Integrazione MCPEsponi intelligence sui domini ad agenti AI e assistenti interni.
Mappa di parametri e risposta
Controlla input, campi di output e codici di stato prima di collegare l’endpoint al tuo client.
Parametro
Risposta di esempio
Codici di stato HTTP
Endpoint
/v1/reverse/ip
Segnali di fiducia prima dell’integrazione
Documentazione trasparente, richieste autenticate e dettagli di affidabilità visibili rendono più semplice valutare DomScan prima del rilascio.
OpenAPI, Swagger, Postman, CLI, SDK e link MCP sono a un clic.
Gli endpoint autenticati usano chiavi API con costi in crediti chiari prima della chiamata.
Inizia con 10.000 crediti mensili e fai upgrade solo quando l’uso cresce.
Parti dagli esempi curl e HTTP, poi mappa i parametri nel codice della tua applicazione.
Caratteristiche Principali
Restituisce solo il numero di voci recenti indicato da limit dall’indice best effort per IP, alimentato da query /v1/dns/all, con deduplicazione per dominio radice attiva per impostazione predefinita.
Questo endpoint non esegue il crawling del DNS, dei file di zona o di un corpus DNS passivo completo.
Usa i risultati come contesto facoltativo, non come prova completa per indagini o dati commerciali.
Restituisce solo il numero di voci recenti indicato da limit dall’indice best effort per IP, alimentato da query /v1/dns/all, con deduplicazione per dominio radice attiva per impostazione predefinita.
Questo endpoint non esegue il crawling del DNS, dei file di zona o di un corpus DNS passivo completo.
Usa i risultati come contesto facoltativo, non come prova completa per indagini o dati commerciali.
Questo endpoint non esegue il crawling del DNS, dei file di zona o di un corpus DNS passivo completo.
Usa i risultati come contesto facoltativo, non come prova completa per indagini o dati commerciali.
Richiesta di esempio
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34"
Risposta di esempio
{
"query": {
"ip": "93.184.216.34",
"asn": null,
"expand": "none",
"dedupe_apex": true
},
"deprecated": true,
"deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
"ip_context": null,
"results": [],
"summary": {
"total_found": 0,
"returned": 0
},
"coverage_summary": {
"source": "passive_dns",
"cache_status": "passive_cache_only",
"passive_index": true,
"result_count": 0,
"returned_count": 0,
"apex_deduped_count": 0,
"warning_count": 2,
"warnings": ["passive_cache_only", "no_cached_matches"],
"last_seen_span_days": null
},
"page": {
"limit": 100,
"next_cursor": null
},
"meta": {
"source": "passive_dns",
"note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
},
"cache": {
"hit": null,
"age_s": null,
"ttl_s": null,
"key": null
}
}
Domande Frequenti
Deprecato: questo endpoint cerca indirizzi IPv4 o IPv6 validi solo in un indice best effort di sette giorni, alimentato da precedenti query /v1/dns/all. Ogni IP conserva al massimo 10,000 voci recenti. L’API valuta il numero di voci indicato da limit prima di restituire, per impostazione predefinita, una riga per dominio radice. Non è un dataset esteso a tutta Internet.
Usa i risultati come contesto facoltativo, non come prova completa per indagini o dati commerciali.
L’indice best effort è alimentato solo da query /v1/dns/all, mantiene le osservazioni per sette giorni e limita ogni IP a 10,000 voci recenti. Scritture mancanti o non riuscite possono creare lacune.
I valori letterali IPv4 e IPv6 validi sono accettati e normalizzati prima della ricerca nell’indice best effort. I risultati dipendono comunque da precedenti osservazioni /v1/dns/all.
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.
Richiesta riuscita
Parametri non validi
Chiave API o sessione mancante o non valida.
Crediti insufficienti per eseguire questa richiesta.
Limite di richieste superato
Errore interno
Errore RDAP upstream
Il servizio a monte non è disponibile o sta limitando temporaneamente le richieste.
La richiesta al servizio a monte è scaduta.
Visualizza il lookup IP inverso deprecato