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

# Intelligence TLD

API DomScan : Obtenez des informations détaillées sur les TLD incluant les tarifs, les restrictions, les scores de confiance et les cas d'usage recommandés.

Obtenez des informations détaillées sur les TLD incluant les tarifs, les restrictions, les scores de confiance et les cas d'usage recommandés.

GET /v1/tlds

#### Paramètres de requête

| Paramètre | Type | Description |
| --- | --- | --- |
| type optionnel | string Valeurs autorisées `gtld`, `cctld`, `new-gtld`, `idn` | Filtrer par type : gTLD, ccTLD, newTLD, idn |
| trust_tier optionnel | string Valeurs autorisées `premium`, `standard`, `economy`, `suspicious` | Filtrer par confiance : premium, standard, economy |
| use_case optionnel | string | Obtenir les TLD pour un cas d'usage (par exemple, "startup", "tech") |

#### Champs de réponse

| Champ | Type |
| --- | --- |
| `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 |

#### Exemple de réponse

```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

#### Exemple de réponse

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

#### Champs de réponse

| Champ | Type |
| --- | --- |
| `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 |
