En direct
État du service
Vérifiez l’état du service en direct et les réponses d’échec documentées avant de procéder à l’intégration.
Catégorie
DNS et réseau
Points de terminaison
1
Fonctionnalités clés
8
Foire aux questions
4
Utilisé par les gens des meilleures entreprises
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
OpenAPI
Artefacts API
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Clés API
Accès protégé
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
10,000
Quota gratuit
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Ce que cette API vous aide à livrer
Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.
Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.
Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.
Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.
Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.
Flux d’intégration
Un parcours simple de la première requête à un usage répétable en production.
Authentifier une fois
Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.
Interroger avec les exemples
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Exploiter et surveiller
Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.
Kit développeur
Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.
Schéma OpenAPI
Générez des clients ou inspectez chaque forme de requête et de réponse.
Collection PostmanImportez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.
SDKs et CLIUtilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.
Intégration MCPExposez l’intelligence de domaines aux agents IA et aux assistants internes.
Carte des paramètres et réponses
Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.
Paramètre
ip
Exemple de Réponse
ipdomaingeolocationgeolocation.countrygeolocation.country_namegeolocation.regiongeolocation.region_namegeolocation.citygeolocation.postalgeolocation.latitudegeolocation.longitudegeolocation.timezone
Codes de Statut HTTP
200400401402429504
Points de terminaison
GET
/v1/ip
ip
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
État du service
Artefacts API
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Clés API
Accès protégé
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
Quota gratuit
Inscrivez-vous Gratuitement
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Actif
Exemple de Requête
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Fonctionnalités clés
Géolocalisation
Ville, région, pays, code postal et coordonnées fournis par le prestataire, toujours approximatifs et parfois incomplets.
Identification du FAI
Consultez le fournisseur d'accès à Internet indiqué pour l'adresse IP.
Recherche d'organisation
Consultez l'organisation que le prestataire associe au réseau.
Informations ASN
Consultez le numéro de système autonome et les informations réseau disponibles.
Contexte d'hébergement
Utilisez les données du prestataire et l'enrichissement des plages cloud, centré sur IPv4, pour évaluer le contexte d'hébergement ou de centre de données.
Signaux de sécurité ciblés
Consultez l'indicateur de proxy du prestataire, une liste sélectionnée de nœuds de sortie Tor et des indices généraux sur les ASN susceptibles d'être liés à un VPN.
Recherche de fuseau horaire
Consultez le fuseau horaire indiqué pour la localisation approximative de l'adresse IP, s'il est disponible.
DNS inverse
Pour IPv4, consultez les résultats PTR et de DNS inverse confirmé par résolution directe (FCrDNS), lorsqu’ils sont disponibles.
Exemple de Requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/ip?ip=8.8.8.8"Exemple de Réponse
{
"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"
}
}Foire aux questions
Quelle est la précision de la géolocalisation ?
La géolocalisation est fournie par le prestataire et reste approximative. La couverture et le niveau de détail varient selon l'adresse et la région. Elle ne doit donc pas servir à déterminer l'emplacement physique précis d'une personne ou d'un appareil.
Puis-je rechercher des adresses IPv6 ?
Oui. Le prestataire principal peut renvoyer des données réseau et de localisation de base pour IPv6, mais les vérifications PTR/FCrDNS et l'enrichissement des plages cloud sont actuellement centrés sur IPv4. Le résultat n'est donc pas identique à celui d'une recherche IPv4.
Quels signaux de sécurité sont inclus ?
Les résultats peuvent inclure l'indicateur de proxy du prestataire principal, les correspondances avec une liste sélectionnée de nœuds de sortie Tor et des indices généraux sur les ASN susceptibles d'être liés à un VPN. Ces signaux ne reposent pas sur une analyse comportementale et ne constituent pas un verdict exhaustif sur les proxys ou les VPN.
Les données sont-elles en temps réel ?
Pas nécessairement. Les données du prestataire principal et les enrichissements de DomScan peuvent être conservés en cache jusqu'à 24 heures, tandis que les sources externes suivent leur propre calendrier. Aucune fréquence de mise à jour quotidienne fixe n'est garantie.
Outils et Ressources Connexes
Codes de Statut HTTP
Nous documentons les codes d'état HTTP que votre client doit gérer afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.
OK
200
Requête réussie
Requête incorrecte
400
Paramètres invalides
Non autorisé
401
Clé API ou session manquante ou invalide.
Paiement requis
402
Crédits insuffisants pour exécuter cette requête.
Trop de requêtes
429
Limite de débit dépassée
Délai d’attente de la passerelle dépassé
504
La requête amont a expiré.
Recherchez une adresse IP