Developer Documentation

Comprehensive top-level domain reference for domain investors, web developers, and registrars. Covers TLD types (gTLD, ccTLD, new gTLD), registrars, pricing, registries, brand TLDs, domain hacks, TLD collections, use case recommendations, industry profiles, timeline, interactive tools, glossary, and in-depth guides. 15 languages supported.

Quick Start

curl -s "https://tldfyi.com/api/v1/rest/tlds/"

API Endpoints

Method Endpoint Description
GET /api/v1/rest/tlds/ List all TLDs
GET /api/v1/rest/tlds/{slug}/ TLD detail
GET /api/v1/rest/registrars/ Registrars
GET /api/v1/rest/pricing/ TLD pricing
GET /api/v1/rest/comparisons/ TLD comparisons
GET /api/v1/rest/glossary-categories/ Glossary categories
GET /api/v1/rest/glossary-terms/ Glossary terms
GET /api/v1/rest/guide-series/ Guide series
GET /api/v1/rest/guides/ Guide articles
GET /api/v1/rest/tools/ Interactive tools
GET /api/v1/rest/industries/ Industry profiles
GET /api/v1/rest/registries/ TLD registries
GET /api/v1/rest/collections/ TLD collections
GET /api/v1/rest/brands/ Brand TLDs
GET /api/v1/rest/domain-hacks/ Domain hacks
GET /api/v1/rest/use-cases/ Use case profiles
GET /api/v1/rest/timeline-eras/ Timeline eras
GET /api/v1/rest/faqs/ FAQs
GET /api/v1/rest/stat-snapshots/ TLD statistics

URL Patterns

Use these patterns to construct URLs programmatically:

/tld/{slug}/ TLD detail (e.g. /tld/com/)
/registrars/ Browse registrars (e.g. /registrars/)
/registrars/{slug}/ Registrar detail (e.g. /registrars/cloudflare/)
/industry/ Industry profiles (e.g. /industry/)
/industry/{slug}/ Industry detail (e.g. /industry/technology/)
/registry/ TLD registries (e.g. /registry/)
/registry/{slug}/ Registry detail (e.g. /registry/verisign/)
/collections/ TLD collections (e.g. /collections/)
/collections/{slug}/ Collection detail (e.g. /collections/short-tlds/)
/brands/ Brand TLDs (e.g. /brands/)
/brands/{slug}/ Brand TLD detail (e.g. /brands/google/)
/domain-hacks/ Domain hacks (e.g. /domain-hacks/)
/domain-hacks/{slug}/ Domain hack detail (e.g. /domain-hacks/del-icio-us/)
/best-tlds/ Use case recommendations (e.g. /best-tlds/)
/best-tlds/{slug}/ Use case detail (e.g. /best-tlds/startups/)
/timeline/ TLD timeline (e.g. /timeline/)
/timeline/{slug}/ Timeline era detail (e.g. /timeline/new-gtld-era/)
/compare/{slug}/ TLD comparison (e.g. /compare/com-vs-net/)
/glossary/ Domain glossary (e.g. /glossary/)
/glossary/{slug}/ Glossary category (e.g. /glossary/dns/)
/guides/ In-depth guides (e.g. /guides/)
/tools/ Interactive tools (e.g. /tools/)
/tools/{slug}/ Tool detail (e.g. /tools/tld-suggest/)
/faq/ FAQ categories (e.g. /faq/)
/search/ Search TLDs, terms, guides (e.g. /search/?q=.dev)

Response Format

All endpoints return JSON with pagination:

Example JSON response
{
  "count": 636,
  "next": "https://example.com/api/v1/items/?page=2",
  "previous": null,
  "results": [
    {"slug": "example", "name": "Example Item", "...": "..."}
  ]
}

OpenAPI Specification

Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.

SDK Packages

PyPI
pip install tldfyi

TLD registry and domain extensions API client

Format Support

  • Markdown endpoints: Append .md to any page URL for LLM-friendly markdown output.
  • Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.