> 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/ja/docs/tld-intelligence

# TLD インテリジェンス

DomScan APIで価格、制限、信頼スコア、推奨される使用例を含むTLDに関する詳細情報を取得します。

価格、制限、信頼スコア、推奨される使用例を含むTLDに関する詳細情報を取得します。

GET /v1/tlds

#### クエリパラメータ

| パラメータ | タイプ | 説明 |
| --- | --- | --- |
| type オプション | string 許可された値 `gtld`, `cctld`, `new-gtld`, `idn` | タイプでフィルタ：gTLD、ccTLD、newTLD、idn |
| trust_tier オプション | string 許可された値 `premium`, `standard`, `economy`, `suspicious` | 信頼でフィルタ：premium、standard、economy |
| use_case オプション | string | 使用例のTLDを取得（例："startup"、"tech"） |

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `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 |

#### レスポンス例

```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": {}
}
```

GET /v1/tlds/:tld

#### レスポンス例

```json
{
                "tld": "io",
                "type": "ccTLD",
                "name": "British Indian Ocean Territory",
                "description": "Popular with tech startups and SaaS companies",
                "introduced": 1997,
                "restrictions": "None - open registration",
                "rdap_supported": true,
                "pricing": {
                "registration_usd": 40,
                "renewal_usd": 40
                },
                "popularity": { "rank": 5, "tier": "top10", "use_cases": ["startup", "tech", "saas"] },
                "trust": { "score": 85, "tier": "premium" }
                }
```

#### レスポンスフィールド

| フィールド | タイプ |
| --- | --- |
| `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 |
