개발자 참고자료

도메인 가용성 확인 API 문서

도메인 가용성 확인 API 문서: 도메인 이름이 하나 이상의 TLD에서 가능한지 확인합니다.

도메인 가용성 확인

도메인 이름이 하나 이상의 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