Référence Développeur

Profil de domaine Documentation de l'API

Profil de domaine Documentation de l'API: Obtenez les données d'enregistrement RDAP normalisées incluant le registraire, la date de création, l'expiration, les serveurs de noms, le statut DNSSEC et le résumé des contacts. Comprend l'âge du domaine précalculé et les jours jusqu'à l'expiration pour plus de commodité.

Profil de domaine

Obtenez les données d'enregistrement RDAP normalisées incluant le registraire, la date de création, l'expiration, les serveurs de noms, le statut DNSSEC et le résumé des contacts. Comprend l'âge du domaine précalculé et les jours jusqu'à l'expiration pour plus de commodité.

GET /v1/profile

Paramètres de Requête

Paramètre	Type	Description
domain requis	string	Nom de domaine complet (par exemple, github.com)

Champs de Réponse

Champ	Type	Description
`age_days`	number	Âge du domaine en jours depuis l'enregistrement
`days_until_expiry`	number	Jours jusqu'à l'expiration du domaine
`dnssec`	boolean	Si DNSSEC est activé
`status`	array	Codes d'état EPP (clientDeleteProhibited, etc.)

Exemple de Requête

curl "https://domscan.net/v1/profile?domain=github.com"

const response = await fetch(
  "https://domscan.net/v1/profile?domain=github.com"
);
const data = await response.json();

console.log(`Domain age: ${data.age_days} days`);
console.log(`Expires in: ${data.days_until_expiry} days`);
console.log(`DNSSEC: ${data.dnssec ? 'Enabled' : 'Disabled'}`);

import requests

response = requests.get(
    "https://domscan.net/v1/profile",
    params={"domain": "github.com"}
)
data = response.json()

print(f"Domain age: {data['age_days']} days ({data['age_days'] // 365} years)")
print(f"Expires in: {data['days_until_expiry']} days")

Exemple de Réponse

{
  "domain": "github.com",
  "registered": true,
  "registrar": "MarkMonitor Inc.",
  "registrar_url": "https://www.markmonitor.com",
  "created_date": "2007-10-09T18:20:50Z",
  "updated_date": "2024-09-08T09:19:27Z",
  "expiry_date": "2026-10-09T07:00:00Z",
  "age_days": 6310,
  "days_until_expiry": 628,
  "nameservers": ["dns1.p08.nsone.net", "dns2.p08.nsone.net"],
  "dnssec": true,
  "status": ["clientDeleteProhibited", "clientTransferProhibited"],
  "contacts": {
    "registrant_name": "GitHub, Inc.",
    "registrant_org": "GitHub, Inc.",
    "registrant_country": "US"
  },
  "privacy": {
    "is_private": false,
    "privacy_service": null
  }
}

GET /v1/overview

Paramètres de Requête

Paramètre	Type	requis
domain	string	requis

Champs de Réponse

Champ	Type
`domain`	string
`health`	object
`health.dns_ok`	boolean
`health.https_ok`	boolean
`dns`	object
`dns.has_a`	boolean
`dns.has_aaaa`	boolean
`dns.has_mx`	boolean
`dns.nameservers[]`	string[]
`registration`	object
`registration.registered`	boolean
`registration.registrar`	string \| null
`registration.created_date`	string \| null
`registration.expiry_date`	string \| null
`registration.age_days`	integer \| null
`registration.days_until_expiry`	integer \| null
`registration.dnssec`	boolean
`reputation`	object
`reputation.score`	number \| null
`reputation.grade`	string \| null
`query_time_ms`	integer
`checked_at`	string

Exemple de Requête

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/overview?domain=example.com"

Exemple de Réponse

{
  "domain": "example.com",
  "health": {
    "dns_ok": true,
    "https_ok": true
  },
  "dns": {
    "has_a": true,
    "has_aaaa": true,
    "has_mx": true,
    "nameservers": [
      "string"
    ]
  },
  "registration": {
    "registered": true,
    "registrar": "string",
    "created_date": "2026-04-15",
    "expiry_date": "2026-04-15",
    "age_days": 1,
    "days_until_expiry": 1,
    "dnssec": true
  },
  "reputation": {
    "score": 1,
    "grade": "string"
  },
  "query_time_ms": "2026-04-15T12:00:00Z",
  "checked_at": "2026-04-15T12:00:00Z"
}