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.
- TLDs with type, registry, restrictions, WHOIS, DNSSEC support
- Registrars with pricing, features, and supported TLDs
- TLD pricing comparison across registrars
- Registries with delegation history and policy details
- Industry profiles — which TLDs suit which industries
- Brand TLDs (.google, .apple, etc.) with ownership and usage
- Domain hacks — creative domain name patterns
- TLD collections curated by theme (short, memorable, geographic, etc.)
- Use case recommendations — best TLDs for blogs, startups, e-commerce
- TLD timeline — historical eras from ARPANET to new gTLDs
- Side-by-side TLD comparisons
- Registrar comparisons with feature matrices
- TLD statistics snapshots
- Interactive tools: domain availability, TLD suggest, TLD score
- Domain glossary with DNS and registration terminology
- In-depth guides organized by series
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
.mdto 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.