OSINT 1 Points de terminaison 8 Fonctionnalités clés

API de Recherche MX inversée (obsolète)

Obsolète : cet endpoint recherche uniquement les noms d’hôte exacts dans un index de sept jours à couverture non garantie, alimenté par de précédentes recherches /v1/dns/all. Chaque hôte MX conserve au maximum 10,000 entrées récentes. L’API évalue le nombre d’entrées indiqué par limit avant de renvoyer, par défaut, une ligne par domaine apex. Ce jeu de données ne couvre pas tout Internet.

Catégorie OSINT
Points de terminaison 1
Fonctionnalités clés 8
Foire aux questions 4

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.

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.

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.

Workflows produit

Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.

Automatisation analyste

Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.

Données JSON propres

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.

IA et opérations

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.

1
Authentifier une fois

Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.

2
Interroger avec les exemples

Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.

3
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.

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ètres de requête

Paramètre

mx
Champs de réponse

Exemple de Réponse

queryquery.mxquery.matchquery.include_apex_onlydeprecateddeprecation_noticeresultssummarysummary.total_foundsummary.returnedfreshness_summaryfreshness_summary.source
Couverture des statuts

Codes de Statut HTTP

200400401402429500502503504

Points de terminaison

GET /v1/reverse/mx
Crédits: 2Authentification: Authentification requise
mx

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

Recherche cache obsolète

Renvoie uniquement le nombre d’entrées récentes indiqué par limit depuis l’index par hôte à couverture non garantie, alimenté par /v1/dns/all, avec déduplication par domaine apex activée par défaut.

Pas mondial

Cet endpoint ne parcourt pas le DNS, les fichiers de zone ni un corpus DNS passif complet.

Signal hérité

Utilisez les résultats comme contexte optionnel, pas comme preuve complète.

Recherche cache obsolète

Renvoie uniquement le nombre d’entrées récentes indiqué par limit depuis l’index par hôte à couverture non garantie, alimenté par /v1/dns/all, avec déduplication par domaine apex activée par défaut.

Pas mondial

Cet endpoint ne parcourt pas le DNS, les fichiers de zone ni un corpus DNS passif complet.

Signal hérité

Utilisez les résultats comme contexte optionnel, pas comme preuve complète.

Recherche cache obsolète

Renvoie uniquement le nombre d’entrées récentes indiqué par limit depuis l’index par hôte à couverture non garantie, alimenté par /v1/dns/all, avec déduplication par domaine apex activée par défaut.

Signal hérité

Utilisez les résultats comme contexte optionnel, pas comme preuve complète.

Exemple de Requête

GET /v1/reverse/mx bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/reverse/mx?mx=aspmx.l.google.com"

Exemple de Réponse

200 OK json
{
  "query": {
    "mx": "aspmx.l.google.com",
    "match": "exact",
    "include_apex_only": 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.",
  "results": [],
  "summary": {
    "total_found": 0,
    "returned": 0
  },
  "freshness_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "result_count": 0,
    "returned_count": 0,
    "apex_domain_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
  }
}

Foire aux questions

Qu'est-ce qu'un enregistrement MX?

Les enregistrements MX (Mail Exchanger) spécifient quels serveurs de messagerie reçoivent les e-mails pour un domaine. Ils incluent une valeur de priorité et le nom d'hôte du serveur.

Comment trouver des domaines par MX?

Obsolète : cet endpoint recherche uniquement les noms d’hôte exacts dans un index de sept jours à couverture non garantie, alimenté par de précédentes recherches /v1/dns/all. Chaque hôte MX conserve au maximum 10,000 entrées récentes. L’API évalue le nombre d’entrées indiqué par limit avant de renvoyer, par défaut, une ligne par domaine apex. Ce jeu de données ne couvre pas tout Internet.

Pourquoi utiliser la recherche MX inversée?

Utilisez les résultats comme contexte optionnel, pas comme preuve complète.

Quelle est la actualité des données?

L’index à couverture non garantie est alimenté uniquement par /v1/dns/all, conserve les observations pendant sept jours et limite chaque hôte MX à 10,000 entrées récentes. Des écritures absentes ou en échec peuvent créer des lacunes.

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

Erreur serveur 500

Erreur interne

Mauvaise passerelle 502

Erreur RDAP en amont

Service indisponible 503

Le service amont est indisponible ou limite temporairement les requêtes.

Délai d’attente de la passerelle dépassé 504

La requête amont a expiré.

Voir la recherche MX inversée obsolète