Sign in

v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-08543999.8 KB
Domain Search

Search for available domains or check specific domain availability

Search for domain availability and pricing. Can check a specific domain (e.g., "example.com") or search terms across multiple TLDs. Supports multiple queries in a single request for efficient batch lookups. Returns a list of matching domains with their availability status, prices, and other details. IMPORTANT: Not all ICANN TLDs are supported. Use ud_tld_list to verify TLD support before searching with specific TLDs.

post/mcp/v1/actions/ud_domains_search

Request body

tldsstring[]

Optional list of up to 5 ICANN TLDs to search (e.g., ["com", "org", "io"]). Must be supported TLDs - use ud_tld_list to verify. Defaults to popular TLDs (com, net, org, ai, io) or inferred from query.

limitnumber

Maximum number of results to return (1-100, default: 20)

offsetnumber

Number of results to skip for pagination (default: 0)

Example request

{
  "tlds": [
    "com",
    "org",
    "io"
  ],
  "limit": 20
}

Response

Search results

searchQuerystring

Sanitized search term (present for single query requests)

searchedTldsstring[]

TLDs that were searched

invalidReasonstring nullable

Validation error reason (present for single query requests)

invalidCharactersstring[] nullable

Invalid characters found (present for single query requests)

truncatedboolean

Whether results were truncated due to size limits

truncationMessagestring

Message explaining truncation

Example response

{
  "results": [
    {
      "pricing": {
        "currency": "USD",
        "formatted": "$9.99"
      }
    }
  ]
}
All 54 operations