Référence Développeur

Vérifier la Disponibilité du Domaine Documentation de l'API

Vérifier la Disponibilité du Domaine Documentation de l'API: Vérifiez si un nom de domaine est disponible sur un ou plusieurs TLD.

Vérifier la Disponibilité du Domaine

Vérifiez si un nom de domaine est disponible sur un ou plusieurs TLD.

GET /v1/status

Paramètres de Requête

Paramètre	Type	Description
name requis	string	Étiquette de domaine sans TLD (par ex.
tlds requis	string	Liste de TLD séparés par des virgules à vérifier (max 50)
prefer_cache optionnel	boolean	Utilisez les résultats mis en cache si disponibles (recommandé)

Exemple de Requête

curl "https://domscan.net/v1/status?name=startup&tlds=com,io,co&prefer_cache=1"

const url = new URL("https://domscan.net/v1/status");
                url.searchParams.set("name", "startup");
                url.searchParams.set("tlds", "com,io,co");
                url.searchParams.set("prefer_cache", "1");
                
                const response = await fetch(url);
                const data = await response.json();
                console.log(data.results);

import requests
                
                params = {"name": "startup", "tlds": "com,io,co", "prefer_cache": 1}
                data = requests.get("https://domscan.net/v1/status", params=params).json()
                print(data["results"])

package main
                
                import (
                "encoding/json"
                "fmt"
                "net/http"
                )
                
                func main() {
                url := "https://domscan.net/v1/status?name=startup&tlds=com,io,co&prefer_cache=1"
                resp, _ := http.Get(url)
                defer resp.Body.Close()
                
                var data map[string]any
                json.NewDecoder(resp.Body).Decode(&data)
                fmt.Println(data["results"])
                }

require 'net/http'
                require 'json'
                
                uri = URI("https://domscan.net/v1/status?name=startup&tlds=com,io,co&prefer_cache=1")
                response = Net::HTTP.get_response(uri)
                data = JSON.parse(response.body)
                puts data["results"]

Exemple de Réponse

{
                "name": "startup",
                "results": [
                {
                "domain": "startup.com",
                "tld": "com",
                "available": false,
                "source": "rdap",
                "checked_at": "2025-01-05T10:30:00.000Z"
                },
                {
                "domain": "startup.io",
                "tld": "io",
                "available": true,
                "source": "rdap",
                "checked_at": "2025-01-05T10:30:00.000Z"
                }
                ],
                "meta": {
                "served_by": "pop=LAX country=US",
                "worker_version": "2.0.0"
                }
                }

Champs de Réponse

Champ	Type
`name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].tld`	string
`results[].available`	boolean \| null
`results[].source`	string
`results[].confidence`	string
`results[].checked_at`	string
`results[].latency_ms`	integer
`results[].error`	string
`meta`	object
`meta.total_checked`	integer
`meta.available_count`	integer
`meta.duration_ms`	integer