Entwickler-Referenz
Domain-Verfügbarkeit überprüfen
DomScan API: Überprüfen Sie, ob ein Domain-Name über eine oder mehrere TLDs verfügbar ist.
Domain-Verfügbarkeit überprüfen
Überprüfen Sie, ob ein Domain-Name über eine oder mehrere TLDs verfügbar ist.
GET
/v1/status
Abfrageparameter
| Parameter | Typ | Beschreibung |
|---|---|---|
| name erforderlich | string | Domain-Label ohne TLD (z. B. |
| tlds erforderlich | string | Komma-getrennte Liste von TLDs zum Überprüfen (max. 50) |
| prefer_cache optional | boolean token | Verwenden Sie zwischengespeicherte Ergebnisse, wenn verfügbar (empfohlen) |
Beispielanfrage
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/status?name=startup&tlds=com,io,co&prefer_cache=1"
const domscanFetch = (url, options = {}) =>
fetch(url, {
...options,
headers: { ...options.headers, "X-API-Key": "your-api-key" },
});
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 domscanFetch(url);
const data = await response.json();
console.log(data.results);
import requests
domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})
params = {"name": "startup", "tlds": "com,io,co", "prefer_cache": 1}
data = domscan.get("https://domscan.net/v1/status", params=params).json()
print(data["results"])
package main
import (
"encoding/json"
"fmt"
"net/http"
"os"
)
func domscanGet(url string) (*http.Response, error) {
request, err := http.NewRequest(http.MethodGet, url, nil)
if err != nil {
return nil, err
}
request.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
return http.DefaultClient.Do(request)
}
func main() {
url := "https://domscan.net/v1/status?name=startup&tlds=com,io,co&prefer_cache=1"
resp, _ := domscanGet(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")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
data = JSON.parse(response.body)
puts data["results"]
Beispielantwort
{
"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.14.0"
}
}
Antwort-Felder
| Feld | Typ |
|---|---|
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 |
confidence_summary |
object |
confidence_summary.scope |
string |
confidence_summary.requested_count |
integer |
confidence_summary.result_count |
integer |
confidence_summary.invalid_count |
integer |
confidence_summary.available_count |
integer |
confidence_summary.registered_count |
integer |
confidence_summary.authoritative_count |
integer |
confidence_summary.heuristic_count |
integer |
confidence_summary.cached_count |
integer |
confidence_summary.error_count |
integer |
confidence_summary.ambiguous_count |
integer |
confidence_summary.source_counts |
object |
confidence_summary.primary_source |
string | null |
confidence_summary.cache_status |
string |
confidence_summary.rdap_calls |
integer |
confidence_summary.refreshes |
integer |
confidence_summary.cache_preference_misses |
integer |
confidence_summary.fallback_chain[] |
string[] |
confidence_summary.confidence_level |
string |
confidence_summary.determinacy_rate |
number |
confidence_summary.ambiguity_reason |
string | null |
meta |
object |
meta.total_checked |
integer |
meta.available_count |
integer |
meta.duration_ms |
integer |