Referencia para Desarrolladores

Comprobar Disponibilidad de Dominio Documentación API

Comprobar Disponibilidad de Dominio Documentación API: Comprueba si un nombre de dominio está disponible en uno o más TLDs.

Comprobar Disponibilidad de Dominio

Comprueba si un nombre de dominio está disponible en uno o más TLDs.

GET /v1/status

Parámetros de consulta

Parámetro	Tipo	Descripción
name obligatorio	string	Etiqueta de dominio sin TLD (p. ej.,
tlds obligatorio	string	Lista de TLDs separados por comas a comprobar (máx. 50)
prefer_cache opcional	boolean	Utiliza resultados en caché cuando estén disponibles (recomendado)

Solicitud de ejemplo

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"]

Respuesta de ejemplo

{
                "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"
                }
                }

Campos de respuesta

Campo	Tipo
`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