API Profil de Domaine
Obtenez un profil complet d'un domaine incluant WHOIS, DNS et les informations d'hébergement. Utilisez cette référence pour choisir le bon endpoint et voir exactement ce qu'il renvoie.
Opérations
GET /v1/profile
GET
/v1/profile
Crédits: 3
Paramètres de requête
| Paramètre | Type | requis |
|---|---|---|
| domain | string | requis |
Champs de réponse
| Champ | Type |
|---|---|
domain |
string |
registered |
boolean | null |
registrar |
string | null |
registrar_url |
string | null |
registrar_iana_id |
string | null |
created_date |
string | null |
updated_date |
string | null |
expiry_date |
string | null |
age_days |
integer |
days_until_expiry |
integer |
nameservers[] |
string[] |
status[] |
string[] |
dnssec |
boolean |
events[] |
object[] |
events[] |
object |
events[].action |
string |
events[].date |
string |
contacts |
object |
contacts.registrant_name |
string | null |
contacts.registrant_org |
string | null |
contacts.registrant_country |
string | null |
contacts.admin_email |
string | null |
contacts.tech_email |
string | null |
privacy |
object |
privacy.is_private |
boolean |
privacy.privacy_service |
string | null |
raw_rdap_link |
string | null |
source_summary |
object |
source_summary.source |
string |
source_summary.authoritative_source |
string |
source_summary.cache_status |
string |
source_summary.fallback_used |
boolean |
source_summary.relay_configured |
boolean |
source_summary.registered |
boolean | null |
source_summary.status_count |
integer |
source_summary.nameserver_count |
integer |
source_summary.event_count |
integer |
source_summary.date_fields_present[] |
string[] |
source_summary.contact_field_count |
integer |
source_summary.privacy_detected |
boolean |
checked_at |
string |
query_time_ms |
integer |
meta |
object |
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/profile?domain=example.com"const response = await fetch("https://domscan.net/v1/profile?domain=example.com", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/profile?domain=example.com",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/profile?domain=example.com", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/profile?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Exemple de réponse
{
"domain": "example.com",
"registered": true,
"registrar": "Example Registrar, Inc.",
"registrar_url": "https://registrar.example.net",
"registrar_iana_id": "9999",
"created_date": "2019-03-11T14:22:08Z",
"updated_date": "2026-03-10T09:41:55Z",
"expiry_date": "2027-03-11T14:22:08Z",
"age_days": 2769,
"days_until_expiry": 153,
"status": [
"client transfer prohibited"
],
"nameservers": [
"ns1.example.net",
"ns2.example.net"
],
"dnssec": false,
"events": [
{
"action": "registration",
"date": "2019-03-11T14:22:08Z"
},
{
"action": "expiration",
"date": "2027-03-11T14:22:08Z"
},
{
"action": "last changed",
"date": "2026-03-10T09:41:55Z"
}
],
"contacts": {
"registrant_name": null,
"registrant_org": null,
"registrant_country": null,
"admin_email": null,
"tech_email": null
},
"privacy": {
"is_private": false,
"privacy_service": null
},
"raw_rdap_link": "https://rdap.example.net/domain/example.com",
"source_summary": {
"source": "rdap",
"authoritative_source": "rdap",
"cache_status": "miss",
"fallback_used": false,
"relay_configured": true,
"registered": true,
"status_count": 1,
"nameserver_count": 2,
"event_count": 3,
"date_fields_present": [
"created_date",
"updated_date",
"expiry_date"
],
"contact_field_count": 0,
"privacy_detected": false
},
"checked_at": "2026-10-09T10:15:30.000Z",
"query_time_ms": 386,
"meta": {
"served_by": "pop=MAD country=ES",
"cached": false
}
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis429Trop de requêtes
POST /v1/profile/bulk
POST
/v1/profile/bulk
Crédits: 3/item
Paramètres de requête
| Paramètre | Type | requis |
|---|---|---|
| dry_run |
string
Valeurs autorisées
true
|
optionnel |
Paramètres du corps
| Paramètre | Type | requis |
|---|---|---|
| domains | string[] | requis |
Champs de réponse
| Champ | Type |
|---|---|
results[] |
unknown[] |
meta |
object |
meta.total |
integer |
meta.succeeded |
integer |
meta.failed |
integer |
meta.max_items |
integer |
meta.credits_per_item |
integer |
meta.duration_ms |
integer |
Exemple de requête
curl -X POST "https://domscan.net/v1/profile/bulk" \
-H "Content-Type: application/json" \
-H "X-API-Key: $DOMSCAN_API_KEY" \
-d '{
"domains": [
"example.com",
"cloudflare.com"
]
}'const response = await fetch("https://domscan.net/v1/profile/bulk", {
method: "POST",
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({
"domains": [
"example.com",
"cloudflare.com"
]
}),
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.post(
"https://domscan.net/v1/profile/bulk",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
json={
"domains": [
"example.com",
"cloudflare.com",
],
},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"domains": [
"example.com",
"cloudflare.com"
]
}`)
req, err := http.NewRequest(http.MethodPost, "https://domscan.net/v1/profile/bulk", body)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/profile/bulk")
request = Net::HTTP::Post.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
request["Content-Type"] = "application/json"
request.body = JSON.generate({
"domains" => [
"example.com",
"cloudflare.com"
]
})
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Exemple de réponse
{
"results": [
{
"input": "example",
"data": {}
}
],
"meta": {
"total": 1,
"succeeded": 1,
"failed": 1,
"max_items": 10,
"credits_per_item": 1,
"duration_ms": 1
}
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis409HTTP 409422HTTP 422429Trop de requêtes
GET /v1/overview
GET
/v1/overview
Crédits: 5
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 | null |
health.https_ok |
boolean | null |
dns |
object |
dns.has_a |
boolean | null |
dns.has_aaaa |
boolean | null |
dns.has_mx |
boolean | null |
dns.nameservers[] |
string[] |
registration |
object |
registration.registered |
boolean | null |
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 | null |
reputation |
object |
reputation.score |
number | null |
reputation.grade |
string | null |
popularity |
object |
popularity.rank |
integer | null |
popularity.bucket |
string | null |
component_freshness |
object |
component_freshness.cache_status |
string |
component_freshness.checked_at |
string |
component_freshness.component_count |
integer |
component_freshness.fresh_component_count |
integer |
component_freshness.degraded_component_count |
integer |
component_freshness.components |
object |
component_freshness.components.health |
object |
component_freshness.components.health.source |
string |
component_freshness.components.health.state |
string |
component_freshness.components.health.checked_at |
string |
component_freshness.components.health.evidence_count |
integer |
component_freshness.components.health.reason |
string | null |
component_freshness.components.dns |
object |
component_freshness.components.dns.source |
string |
component_freshness.components.dns.state |
string |
component_freshness.components.dns.checked_at |
string |
component_freshness.components.dns.evidence_count |
integer |
component_freshness.components.dns.reason |
string | null |
component_freshness.components.registration |
object |
component_freshness.components.registration.source |
string |
component_freshness.components.registration.state |
string |
component_freshness.components.registration.checked_at |
string |
component_freshness.components.registration.evidence_count |
integer |
component_freshness.components.registration.reason |
string | null |
component_freshness.components.reputation |
object |
component_freshness.components.reputation.source |
string |
component_freshness.components.reputation.state |
string |
component_freshness.components.reputation.checked_at |
string |
component_freshness.components.reputation.evidence_count |
integer |
component_freshness.components.reputation.reason |
string | null |
component_freshness.components.popularity |
object |
component_freshness.components.popularity.source |
string |
component_freshness.components.popularity.state |
string |
component_freshness.components.popularity.checked_at |
string |
component_freshness.components.popularity.evidence_count |
integer |
component_freshness.components.popularity.reason |
string | null |
query_time_ms |
integer |
checked_at |
string |
meta |
object |
meta.served_by |
string |
meta.cached |
boolean |
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/overview?domain=example.com"const response = await fetch("https://domscan.net/v1/overview?domain=example.com", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/overview?domain=example.com",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/overview?domain=example.com", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/overview?domain=example.com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Exemple de réponse
{
"domain": "example.com",
"health": {
"dns_ok": true,
"https_ok": true
},
"dns": {
"has_a": true,
"has_aaaa": true,
"has_mx": false,
"nameservers": [
"ns1.example.net",
"ns2.example.net"
]
},
"registration": {
"registered": true,
"registrar": "Example Registrar, Inc.",
"created_date": "2019-03-11T14:22:08Z",
"expiry_date": "2027-03-11T14:22:08Z",
"age_days": 2769,
"days_until_expiry": 153,
"dnssec": false
},
"reputation": {
"score": 82,
"grade": "A"
},
"popularity": {
"rank": 18452,
"bucket": "top-100k"
},
"component_freshness": {
"cache_status": "miss",
"checked_at": "2026-10-09T10:15:30.000Z",
"component_count": 5,
"fresh_component_count": 5,
"degraded_component_count": 0,
"components": {
"health": {
"source": "quick_health",
"state": "fresh",
"checked_at": "2026-10-09T10:15:30.000Z",
"evidence_count": 2
},
"dns": {
"source": "dns",
"state": "fresh",
"checked_at": "2026-10-09T10:15:30.000Z",
"evidence_count": 4
},
"registration": {
"source": "rdap",
"state": "fresh",
"checked_at": "2026-10-09T10:15:30.000Z",
"evidence_count": 7
},
"reputation": {
"source": "reputation",
"state": "fresh",
"checked_at": "2026-10-09T10:15:30.000Z",
"evidence_count": 2
},
"popularity": {
"source": "popularity",
"state": "fresh",
"checked_at": "2026-10-09T10:15:30.000Z",
"evidence_count": 2
}
}
},
"query_time_ms": 1840,
"checked_at": "2026-10-09T10:15:30.000Z",
"meta": {
"served_by": "pop=MAD country=ES",
"cached": false
}
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis429Trop de requêtes
GET /v1/popularity
GET
/v1/popularity
Crédits: 2
Paramètres de requête
| Paramètre | Type | requis |
|---|---|---|
| domain | string | requis |
| include_history |
boolean
Défaut
false
|
optionnel |
| history_limit |
integer
Défaut
30
|
optionnel |
Champs de réponse
| Champ | Type |
|---|---|
domain |
string |
status |
string |
rank |
integer | null |
bucket |
string |
source |
object |
source.id |
string |
source.url |
string |
source.list_date |
string | null |
source.provenance |
object |
source.provenance.owner |
string |
source.provenance.source_url |
string |
source.provenance.methodology_url |
string |
source.provenance.access_method |
string |
source.provenance.cost |
string |
source.provenance.runtime_rate_limits |
string |
source.provenance.terms_status |
string |
source.provenance.expected_freshness |
string |
source.provenance.maintenance_risk |
string |
source.provenance.fallback_behavior |
string |
source.provenance.last_verified |
string |
freshness |
object |
freshness.cache_status |
string |
freshness.ttl_seconds |
integer |
checked_at |
string |
result_count |
integer | null |
empty_result |
boolean |
history |
object |
history.collection |
string |
history.complete_daily_series |
boolean |
history.available |
boolean |
history.observations[] |
object[] |
history.observations[] |
object |
history.observations[].domain |
string |
history.observations[].rank |
integer | null |
history.observations[].bucket |
string |
history.observations[].status |
string |
history.observations[].source |
string |
history.observations[].list_date |
string | null |
history.observations[].observed_on |
string |
history.observations[].checked_at |
string |
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30"const response = await fetch("https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/popularity?domain=example.com&include_history=false&history_limit=30")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Exemple de réponse
{
"domain": "example.com",
"status": "ranked",
"rank": 18452,
"bucket": "top-100k",
"source": {
"id": "tranco",
"url": "https://tranco-list.eu/",
"list_date": "2026-10-08",
"provenance": {
"owner": "Tranco research project",
"source_url": "https://tranco-list.eu/",
"methodology_url": "https://tranco-list.eu/methodology",
"access_method": "public_domain_rank_api",
"cost": "none",
"runtime_rate_limits": "not_published_cached_and_bounded_by_domscan",
"terms_status": "mixed_upstream_licenses_review_required_for_commercial_reuse",
"expected_freshness": "daily",
"maintenance_risk": "medium",
"fallback_behavior": "return_unknown_without_inventing_or_reusing_an_unranked_result",
"last_verified": "2026-08-02"
}
},
"freshness": {
"cache_status": "miss",
"ttl_seconds": 86400
},
"checked_at": "2026-10-09T10:15:30.000Z",
"result_count": 1,
"empty_result": false,
"history": {
"collection": "lookup_driven",
"complete_daily_series": false,
"available": true,
"observations": [
{
"domain": "example.com",
"rank": 18452,
"bucket": "top-100k",
"status": "ranked",
"source": "tranco",
"list_date": "2026-10-08",
"observed_on": "2026-10-09",
"checked_at": "2026-10-09T10:15:30.000Z"
},
{
"domain": "example.com",
"rank": 18877,
"bucket": "top-100k",
"status": "ranked",
"source": "tranco",
"list_date": "2026-10-01",
"observed_on": "2026-10-02",
"checked_at": "2026-10-02T10:15:30.000Z"
}
]
}
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis429Trop de requêtes
GET /v1/popularity/history
GET
/v1/popularity/history
Crédits: 1
Paramètres de requête
| Paramètre | Type | requis |
|---|---|---|
| domain | string | requis |
| limit |
integer
Défaut
30
|
optionnel |
Champs de réponse
| Champ | Type |
|---|---|
domain |
string |
collection |
string |
complete_daily_series |
boolean |
result_count |
integer |
empty_result |
boolean |
observations[] |
object[] |
observations[] |
object |
observations[].domain |
string |
observations[].rank |
integer | null |
observations[].bucket |
string |
observations[].status |
string |
observations[].source |
string |
observations[].list_date |
string | null |
observations[].observed_on |
string |
observations[].checked_at |
string |
Exemple de requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/popularity/history?domain=example.com&limit=25"const response = await fetch("https://domscan.net/v1/popularity/history?domain=example.com&limit=25", {
headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);import os
import requests
response = requests.get(
"https://domscan.net/v1/popularity/history?domain=example.com&limit=25",
headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/popularity/history?domain=example.com&limit=25", nil)
if err != nil {
panic(err)
}
req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
data, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(resp.Status, string(data))
}require "json"
require "net/http"
uri = URI("https://domscan.net/v1/popularity/history?domain=example.com&limit=25")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))Exemple de réponse
{
"domain": "example.com",
"collection": "lookup_driven",
"complete_daily_series": false,
"result_count": 1,
"empty_result": false,
"observations": [
{
"domain": "example.com",
"rank": 1,
"bucket": "top-100",
"status": "ranked",
"source": "tranco",
"list_date": "2026-08-27",
"observed_on": "2026-08-27",
"checked_at": "2026-08-27T12:00:00Z"
}
]
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis429Trop de requêtes500Erreur serveur