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

# Analiza TLD

DomScan API do analizy domen: Uzyskaj szczegółowe informacje o TLD, w tym cenach, ograniczeniach, wynikach zaufania i zalecanych zastosowaniach.

Uzyskaj szczegółowe informacje o TLD, w tym cenach, ograniczeniach, wynikach zaufania i zalecanych zastosowaniach.

GET /v1/tlds

#### Parametry zapytania

| Parametr | Typ | Opis |
| --- | --- | --- |
| type opcjonalne | string Dozwolone wartości `gtld`, `cctld`, `new-gtld`, `idn` | Filtruj według typu: gTLD, ccTLD, newTLD, idn |
| trust_tier opcjonalne | string Dozwolone wartości `premium`, `standard`, `economy`, `suspicious` | Filtruj według zaufania: premium, standard, economy |
| use_case opcjonalne | string | Pobierz TLD dla zastosowania, np. "startup" lub "tech" |

#### Pola odpowiedzi

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

#### Przykładowa odpowiedź

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

#### Przykładowa odpowiedź

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

#### Pola odpowiedzi

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