域名配置文件 API 参考
获取域名的全面配置文件,包括 WHOIS、DNS 和托管信息。 通过本参考选择合适的端点,并准确了解它返回的内容。
操作
GET /v1/profile
GET
/v1/profile
积分: 3
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| domain | string | 必需 |
响应字段
| 字段 | 类型 |
|---|---|
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 |
请求示例
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))响应示例
{
"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
}
}
HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多
POST /v1/profile/bulk
POST
/v1/profile/bulk
积分: 3/item
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| dry_run |
string
允许的值
true
|
可选 |
正文参数
| 参数 | 类型 | 必需 |
|---|---|---|
| domains | string[] | 必需 |
响应字段
| 字段 | 类型 |
|---|---|
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 |
请求示例
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))响应示例
{
"results": [
{
"input": "example",
"data": {}
}
],
"meta": {
"total": 1,
"succeeded": 1,
"failed": 1,
"max_items": 10,
"credits_per_item": 1,
"duration_ms": 1
}
}
HTTP 状态码
200成功400请求错误401未授权402需要付款409HTTP 409422HTTP 422429请求过多
GET /v1/overview
GET
/v1/overview
积分: 5
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| domain | string | 必需 |
响应字段
| 字段 | 类型 |
|---|---|
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 |
请求示例
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))响应示例
{
"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
}
}
HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多
GET /v1/popularity
GET
/v1/popularity
积分: 2
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| domain | string | 必需 |
| include_history |
boolean
默认值
false
|
可选 |
| history_limit |
integer
默认值
30
|
可选 |
响应字段
| 字段 | 类型 |
|---|---|
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 |
请求示例
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))响应示例
{
"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"
}
]
}
}
HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多
GET /v1/popularity/history
GET
/v1/popularity/history
积分: 1
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| domain | string | 必需 |
| limit |
integer
默认值
30
|
可选 |
响应字段
| 字段 | 类型 |
|---|---|
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 |
请求示例
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))响应示例
{
"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"
}
]
}
HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多500服务器错误