Documentation API Dom-Verify

Business

L'API Dom-Verify vous permet d'analyser des domaines expirés de façon programmatique, directement depuis vos scripts, outils internes ou workflows automatisés — sans passer par l'interface web.

Base URL

https://dom-verify.fr/api

Format

JSON

Plan requis

Business (99€/mois)

Authentification

Chaque requête doit inclure votre clé API dans le header X-API-Key. La clé est au format dv_sk_... et est générée depuis votre dashboard.

# Header requis sur toutes les requêtes X-API-Key: dv_sk_votre_cle_ici

⚠️ Ne partagez jamais votre clé API. Stockez-la dans une variable d'environnement, jamais en dur dans votre code source.

Obtenir votre clé API

La clé API est réservée au plan Business. Pour en obtenir une :

1

Souscrivez au plan Business sur dom-verify.fr

2

Connectez-vous à votre dashboard

3

Dans la section Clé API, cliquez sur Générer ma clé API

4

Copiez et stockez votre clé — elle ne sera affichée qu'une seule fois en clair

POST /analyze

Analyse un nom de domaine expiré via 8 modules : Wayback Machine, VirusTotal, WHOIS, Moz, Réputation Email, Historique IP, Contenu archivé et Marques Déposées. Retourne un score global sur 100 et les données détaillées de chaque module.

Paramètres du body (JSON)

Paramètre Type Description

domain string Nom de domaine à analyser (ex: example.fr). Sans http/https.

Headers requis

Header Valeur Description

X-API-Key string Votre clé API Business (dv_sk_...)

Content-Type string application/json

Format de réponse

        
{
  "domain": "example.fr",
  "score": 74,
  "analysis_time": 8.42,
  "analyses": {
    "wayback": {
      "score": 20,
      "snapshots": 142,
      "first_seen": "2012-03-15",
      "last_seen": "2024-11-02",
      "error": null
    },
    "virustotal": {
      "score": 25,
      "malicious": 0,
      "suspicious": 0,
      "harmless": 67,
      "undetected": 8,
      "total_vendors": 75,
      "error": null
    },
    "whois": {
      "score": 18,
      "age_years": 11,
      "registrar": "OVH SAS",
      "status": "pendingDelete",
      "creation_date": "2012-03-15",
      "expiration_date": "2025-03-15",
      "error": null
    },
    "pagespeed": {
      "score": 8,
      "mobile": 34,
      "desktop": 61,
      "error": null
    },
    "moz": {
      "score": 21,
      "domain_authority": 38,
      "spam_score": 4,
      "linking_domains": 214,
      "error": null
    }
  }
}
      

Modules d'analyse

Le score global sur 100 est la somme des 5 modules divisée par 1,25. Chaque module contribue jusqu'à 25 points.

Module Max Ce qu'il mesure

Wayback 25 pts Historique du domaine — nombre de snapshots, ancienneté

VirusTotal 25 pts Réputation sécurité — détections malveillantes sur 75+ moteurs

WHOIS 25 pts Données registrar — ancienneté, statut EPP, dates

25 pts

Moz 25 pts Autorité SEO — Domain Authority, Spam Score, domaines référents

Codes d'erreur

Code HTTP Detail Cause

401 Unauthorized Clé API absente ou invalide

403 Forbidden Plan insuffisant (Pro ou Free)

400 Nom de domaine invalide Domaine manquant ou trop court (< 3 caractères)

429 LIMIT_REACHED Quota journalier atteint (500 analyses/jour)

500 Internal Server Error Erreur serveur — réessayez dans quelques secondes

Limites et quotas

Analyses / jour

500

Remise à zéro à minuit UTC

Temps de réponse

~10s

5 modules en parallèle

Clés API

1

Révocable depuis le dashboard

Exemple — cURL

curl -X POST https://dom-verify.fr/api/analyze \ -H "X-API-Key: dv_sk_votre_cle_ici" \ -H "Content-Type: application/json" \ -d '{"domain": "example.fr"}'

Exemple — Python

import requests API_KEY = "dv_sk_votre_cle_ici" DOMAIN = "example.fr" response = requests.post( "https://dom-verify.fr/api/analyze", headers={ "X-API-Key": API_KEY, "Content-Type": "application/json" }, json={"domain": DOMAIN} ) data = response.json() print(f"Score global : {data['score']}/100") print(f"Domain Authority Moz : {data['analyses']['moz']['domain_authority']}") print(f"VirusTotal malicious : {data['analyses']['virustotal']['malicious']}")

Exemple — JavaScript