Referência de Programador

Verificar Disponibilidade de Domínio Documentação da API

Verificar Disponibilidade de Domínio Documentação da API: Verifique se um nome de domínio está disponível em um ou mais TLDs.

Verificar Disponibilidade de Domínio

Verifique se um nome de domínio está disponível em um ou mais TLDs.

GET /v1/status

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
name obrigatório	string	Etiqueta de domínio sem TLD (p.ex.,
tlds obrigatório	string	Lista de TLDs separados por vírgula a verificar (máx. 50)
prefer_cache opcional	boolean	Utilize resultados em cache quando disponível (recomendado)

Pedido de Exemplo

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

Resposta de Exemplo

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

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