開発者向けリファレンス
ドメイン可用性を確認 APIドキュメント
ドメイン可用性を確認 APIドキュメント: ドメイン名が 1 つ以上の TLD 全体で利用可能かどうかを確認します。
ドメイン可用性を確認
ドメイン名が 1 つ以上の TLD 全体で利用可能かどうかを確認します。
GET
/v1/status
クエリパラメータ
| パラメータ | タイプ | 説明 |
|---|---|---|
| name 必須 | string | TLD なしのドメインラベル (例えば、 |
| tlds 必須 | string | チェックする TLD のカンマ区切りリスト (最大 50) |
| prefer_cache オプション | boolean | 利用可能な場合はキャッシュされた結果を使用 (推奨) |
リクエスト例
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"]
レスポンス例
{
"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"
}
}
レスポンスフィールド
| フィールド | タイプ |
|---|---|
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 |