Referencia para Desarrolladores

Comprobación de Dominio en Lotes Documentación API

Comprobación de Dominio en Lotes Documentación API: Comprueba disponibilidad para múltiples nombres de dominio de una vez. Soporta hasta 50 dominios por solicitud.

Comprobación de Dominio en Lotes

Comprueba disponibilidad para múltiples nombres de dominio de una vez. Soporta hasta 50 dominios por solicitud.

POST /v1/status/bulk

Cuerpo de la solicitud

Campo	Tipo	Descripción
domains obligatorio	string[]	Array de nombres de dominio completos a comprobar
options.prefer_cache opcional	boolean	Utiliza resultados en caché cuando estén disponibles

Solicitud de ejemplo

curl -X POST "https://domscan.net/v1/status/bulk" \
                -H "Content-Type: application/json" \
                -d '{"domains": ["mybrand.com", "mybrand.io"], "options": {"prefer_cache": true}}'

const response = await fetch("https://domscan.net/v1/status/bulk", {
                method: "POST",
                headers: { "Content-Type": "application/json" },
                body: JSON.stringify({
                domains: ["mybrand.com", "mybrand.io"],
                options: { prefer_cache: true }
                })
                });
                const data = await response.json();
                console.log(data.results);

import requests
                
                payload = {
                "domains": ["mybrand.com", "mybrand.io"],
                "options": {"prefer_cache": True}
                }
                response = requests.post(
                "https://domscan.net/v1/status/bulk",
                json=payload,
                timeout=10
                )
                print(response.json()["results"])

package main
                
                import (
                "bytes"
                "encoding/json"
                "fmt"
                "net/http"
                )
                
                func main() {
                payload := map[string]any{
                "domains": []string{"mybrand.com", "mybrand.io"},
                "options": map[string]bool{"prefer_cache": true},
                }
                body, _ := json.Marshal(payload)
                resp, err := http.Post("https://domscan.net/v1/status/bulk", "application/json", bytes.NewReader(body))
                if err != nil {
                panic(err)
                }
                defer resp.Body.Close()
                fmt.Println(resp.Status)
                }

require 'net/http'
                require 'json'
                
                uri = URI("https://domscan.net/v1/status/bulk")
                http = Net::HTTP.new(uri.host, uri.port)
                http.use_ssl = true
                
                request = Net::HTTP::Post.new(uri)
                request["Content-Type"] = "application/json"
                request.body = {
                domains: ["mybrand.com", "mybrand.io"],
                options: { prefer_cache: true }
                }.to_json
                
                response = http.request(request)
                data = JSON.parse(response.body)
                puts data["results"]

Campos de respuesta

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

Respuesta de ejemplo

{
  "results": [
    {
      "domain": "example.com",
      "tld": "com",
      "available": false,
      "source": "rdap",
      "latency_ms": 45
    },
    {
      "domain": "startup.io",
      "tld": "io",
      "available": true,
      "source": "rdap",
      "latency_ms": 67
    },
    {
      "domain": "brand.ai",
      "tld": "ai",
      "available": true,
      "source": "cache",
      "latency_ms": 2
    }
  ],
  "meta": {
    "total_checked": 3,
    "available_count": 2,
    "duration_ms": 120
  }
}