名称可用性 API API 参考
一次检查名称在域名、社交账号名和软件包注册表中的可用性。 使用此参考选择操作，并集成其文档化的响应契约。
操作
GET /v1/name-check
GET
/v1/name-check
积分: 5
查询参数
| 参数 | 类型 | 必需 |
|---|---|---|
| name | string | 必需 |
| tlds | string | 可选 |
| platforms | string | 可选 |
| packages | string | 可选 |
响应字段
| 字段 | 类型 |
|---|---|
name |
string |
status |
string |
checked_at |
string |
verdict |
string |
score |
integer | null |
determinacy |
integer |
summary |
object |
summary.com_available |
boolean | null |
summary.domains |
object |
summary.domains.checked |
integer |
summary.domains.free |
integer |
summary.domains.taken |
integer |
summary.domains.unknown |
integer |
summary.handles |
object |
summary.handles.checked |
integer |
summary.handles.free |
integer |
summary.handles.taken |
integer |
summary.handles.unknown |
integer |
summary.packages |
object |
summary.packages.checked |
integer |
summary.packages.free |
integer |
summary.packages.taken |
integer |
summary.packages.unknown |
integer |
domains[] |
object[] |
domains[] |
object |
domains[].domain |
string |
domains[].tld |
string |
domains[].status |
string |
domains[].reason |
string | null |
handles[] |
object[] |
handles[] |
object |
handles[].platform |
string |
handles[].status |
string |
handles[].url |
string | null |
handles[].reason |
string | null |
packages[] |
object[] |
packages[] |
object |
packages[].registry |
string |
packages[].name |
string |
packages[].status |
string |
packages[].url |
string | null |
packages[].reason |
string | null |
meta |
object |
meta.duration_ms |
integer |
请求示例
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/name-check?name=acmeflow&tlds=com%2Cio%2Cai&platforms=github%2Cinstagram%2Ctiktok&packages=npm%2Cpypi"const response = await fetch("https://domscan.net/v1/name-check?name=acmeflow&tlds=com%2Cio%2Cai&platforms=github%2Cinstagram%2Ctiktok&packages=npm%2Cpypi", {
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/name-check?name=acmeflow&tlds=com%2Cio%2Cai&platforms=github%2Cinstagram%2Ctiktok&packages=npm%2Cpypi",
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/name-check?name=acmeflow&tlds=com%2Cio%2Cai&platforms=github%2Cinstagram%2Ctiktok&packages=npm%2Cpypi", 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/name-check?name=acmeflow&tlds=com%2Cio%2Cai&platforms=github%2Cinstagram%2Ctiktok&packages=npm%2Cpypi")
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))响应示例
{
"name": "acmeflow",
"status": "ok",
"checked_at": "2026-10-13T18:00:00.000Z",
"verdict": "mostly_available",
"score": 80,
"determinacy": 100,
"summary": {
"com_available": false,
"domains": {
"checked": 2,
"free": 1,
"taken": 1,
"unknown": 0
},
"handles": {
"checked": 2,
"free": 2,
"taken": 0,
"unknown": 0
},
"packages": {
"checked": 1,
"free": 1,
"taken": 0,
"unknown": 0
}
},
"domains": [
{
"domain": "acmeflow.com",
"tld": "com",
"status": "taken",
"reason": null
},
{
"domain": "acmeflow.io",
"tld": "io",
"status": "available",
"reason": null
}
],
"handles": [
{
"platform": "github",
"status": "available",
"url": null,
"reason": null
},
{
"platform": "instagram",
"status": "available",
"url": null,
"reason": null
}
],
"packages": [
{
"registry": "npm",
"name": "acmeflow",
"status": "not_found",
"url": null,
"reason": "similar_name_rules"
}
],
"meta": {
"duration_ms": 4210
}
}HTTP 状态码
200成功400请求错误401未授权402需要付款429请求过多