> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/ko/docs/products/tld-intelligence

# TLD 인텔리전스 API 레퍼런스

가격, 제한 사항, 등록 대행자 지원 및 사용 통계를 포함한 TLD에 대한 상세한 인텔리전스를 받습니다. 이 레퍼런스에서 알맞은 엔드포인트를 고르고 반환되는 결과를 정확히 확인하세요.

[제품 페이지 보기](https://domscan.net/ko/tld-intelligence)

## 작업

GET `/v1/tlds` [API 레퍼런스 보기](https://domscan.net/ko/docs/products/tld-intelligence#getTlds)

GET `/v1/tlds/:tld` [API 레퍼런스 보기](https://domscan.net/ko/docs/products/tld-intelligence#getTldDetail)

## GET `/v1/tlds`

작업: `getTlds`
크레딧 및 인증: 무료
인증 선택 사항

GET /v1/tlds 크레딧: 0

#### 쿼리 매개변수

| 매개변수 | 유형 | 필수 |
| --- | --- | --- |
| type | string 허용된 값 `gtld`, `cctld`, `new-gtld`, `idn` | 선택 사항 |
| trust_tier | string 허용된 값 `premium`, `standard`, `economy`, `suspicious` | 선택 사항 |
| use_case | string | 선택 사항 |

#### 응답 필드

| 필드 | 유형 |
| --- | --- |
| `tlds[]` | object[] |
| `tlds[]` | object |
| `tlds[].tld` | string |
| `tlds[].type` | string |
| `tlds[].name` | string |
| `tlds[].rdap_supported` | boolean |
| `tlds[].trust_tier` | string |
| `tlds[].popularity_rank` | integer |
| `tlds[].registration_usd` | number |
| `total` | integer |
| `by_type` | object |
| `by_type.gTLD` | integer |
| `by_type.ccTLD` | integer |
| `by_type.newTLD` | integer |
| `by_type.idn` | integer |
| `by_trust_tier` | object |
| `by_trust_tier.premium` | integer |
| `by_trust_tier.standard` | integer |
| `by_trust_tier.economy` | integer |
| `use_case` | string |
| `meta` | object |

#### 예제 요청

```bash
curl "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup"
```

```javascript
const response = await fetch("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup");
const data = await response.json();
console.log(data);
```

```python
import requests

response = requests.get(
    "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup",
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup", nil)
	if err != nil {
		panic(err)
	}

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/tlds?type=gtld&trust_tier=premium&use_case=startup")
request = Net::HTTP::Get.new(uri)

#### 예제 응답

```json
{
  "tlds": [
    {
      "tld": "com",
      "type": "gTLD",
      "name": "example",
      "rdap_supported": false,
      "trust_tier": "premium",
      "popularity_rank": 1,
      "registration_usd": 0.5
    }
  ],
  "total": 1,
  "by_type": {
    "gTLD": 1,
    "ccTLD": 1,
    "newTLD": 1,
    "idn": 1
  },
  "by_trust_tier": {
    "premium": 1,
    "standard": 1,
    "economy": 1
  },
  "use_case": "example",
  "meta": {}
}
```

#### HTTP 상태 코드

- `200` 성공
- `429` 요청 과다

## GET `/v1/tlds/:tld`

작업: `getTldDetail`
크레딧 및 인증: 1
인증 필요

GET /v1/tlds/:tld 크레딧: 1

#### 쿼리 매개변수

| 매개변수 | 유형 | 필수 |
| --- | --- | --- |
| tld | string | 필수 |

#### 응답 필드

| 필드 | 유형 |
| --- | --- |
| `tld` | string |
| `type` | string |
| `name` | string |
| `description` | string |
| `introduced` | integer |
| `operator` | string \| null |
| `country` | string \| null |
| `restrictions` | string |
| `rdap_supported` | boolean |
| `rdap_endpoint` | string \| null |
| `idn_supported` | boolean |
| `dnssec_supported` | boolean |
| `pricing` | object |
| `pricing.registration_usd` | number |
| `pricing.renewal_usd` | number |
| `pricing.transfer_usd` | number |
| `pricing.currency` | string |
| `pricing.source` | string |
| `popularity` | object |
| `popularity.rank` | integer |
| `popularity.tier` | string |
| `popularity.use_cases[]` | string[] |
| `trust` | object |
| `trust.score` | number |
| `trust.tier` | string |
| `trust.notes` | string \| null |
| `meta` | object |

#### 예제 요청

```bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/tlds/com"
```

```javascript
const response = await fetch("https://domscan.net/v1/tlds/com", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
```

```python
import os
import requests

response = requests.get(
    "https://domscan.net/v1/tlds/com",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/tlds/com", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
```

```ruby
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/tlds/com")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))
```

#### 예제 응답

```json
{
  "tld": "com",
  "type": "gTLD",
  "name": "Commercial",
  "description": "The most popular and trusted domain extension worldwide",
  "introduced": 1985,
  "operator": "Verisign",
  "restrictions": "None - open registration",
  "rdap_supported": true,
  "rdap_endpoint": "https://rdap.verisign.com/com/v1/",
  "idn_supported": true,
  "dnssec_supported": true,
  "pricing": {
    "registration_usd": 12,
    "renewal_usd": 12,
    "transfer_usd": 12,
    "currency": "USD",
    "source": "market_average"
  },
  "popularity": {
    "rank": 1,
    "tier": "top10",
    "use_cases": [
      "business",
      "personal",
      "startup",
      "enterprise",
      "tech",
      "e-commerce",
      "blog",
      "portfolio"
    ]
  },
  "trust": {
    "score": 100,
    "tier": "premium",
    "notes": "Most trusted TLD globally"
  },
  "meta": {
    "served_by": "pop=MAD country=ES"
  }
}
```

#### HTTP 상태 코드

- `200` 성공
- `401` 인증되지 않음
- `402` 결제 필요
- `404` 찾을 수 없음
- `429` 요청 과다

## 레퍼런스 리소스

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/ko/mcp-domain-checker)
