> 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/products/tld-intelligence

# API Intelligence TLD

Obtenez une intelligence détaillée sur un TLD incluant les prix, les restrictions, le support des registraires et les statistiques d'utilisation. Utilisez cette référence pour choisir le bon endpoint et voir exactement ce qu'il renvoie.

[Voir la page du produit](https://domscan.net/fr/tld-intelligence)

## Opérations

GET `/v1/tlds` [Voir la référence API](https://domscan.net/fr/docs/products/tld-intelligence#getTlds)

GET `/v1/tlds/:tld` [Voir la référence API](https://domscan.net/fr/docs/products/tld-intelligence#getTldDetail)

## GET `/v1/tlds`

Opération: `getTlds`
Crédits et authentification: Gratuit
Authentification facultative

GET /v1/tlds Crédits: 0

#### Paramètres de requête

| Paramètre | Type | requis |
| --- | --- | --- |
| type | string Valeurs autorisées `gtld`, `cctld`, `new-gtld`, `idn` | optionnel |
| trust_tier | string Valeurs autorisées `premium`, `standard`, `economy`, `suspicious` | optionnel |
| use_case | string | optionnel |

#### 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 requête

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

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

#### Codes de statut HTTP

- `200` OK
- `429` Trop de requêtes

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

Opération: `getTldDetail`
Crédits et authentification: 1
Authentification requise

GET /v1/tlds/:tld Crédits: 1

#### Paramètres de requête

| Paramètre | Type | requis |
| --- | --- | --- |
| tld | string | requis |

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

#### Exemple de requête

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

#### Exemple de réponse

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

#### Codes de statut HTTP

- `200` OK
- `401` Non autorisé
- `402` Paiement requis
- `404` Introuvable
- `429` Trop de requêtes

## Ressources de référence

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