API API de disponibilité des noms
Vérifiez un nom sur les domaines, les identifiants sociaux et les registres de paquets en une fois. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.
Opérations
GET /v1/name-check
GET
/v1/name-check
Crédits: 5
Paramètres de requête
| Paramètre | Type | requis |
|---|---|---|
| name | string | requis |
| tlds | string | optionnel |
| platforms | string | optionnel |
| packages | string | optionnel |
Champs de réponse
| Champ | Type |
|---|---|
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 |
Exemple de requête
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))Exemple de réponse
{
"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
}
}
Codes de statut HTTP
200OK400Requête incorrecte401Non autorisé402Paiement requis429Trop de requêtes