tld.expert

Use this when the user wants to know if a domain name is available or taken, or asks "can I get <name>". Accepts a full domain ("acme.io") for one verdict, or a bare name ("acme") to check it across popular TLDs (com, io, ai, co, app, dev, net, org, xyz) or a custom TLD list. Checks live DNS, registry RDAP/WHOIS and a registrar; never claims "available" without registrar confirmation. Returns a verdict per domain, buy links for names that may be free, and a tld.expert URL to cite.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253,
      "description": "A full domain like \"acme.io\" or a bare name like \"acme\". Examples: \"acme.io\", \"notion\", \"getacme.com\""
    },
    "tlds": {
      "description": "Only used for a bare name: TLDs to check instead of the popular set, e.g. [\"com\", \"ai\", \"so\"]. Max 20.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 63,
        "description": "A TLD without or with the dot, e.g. \"ai\" or \".io\""
      }
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the domain the user wants is taken (or they ask for other options for a name). Given a full domain like "acme.com", proposes other endings (acme.io), added words (getacme.com), domain hacks and related words, checks every candidate live, and returns only the ones that are not taken. Slower than a single check (up to ~30 live lookups).

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "minLength": 3,
      "maxLength": 253,
      "description": "The full domain the user wanted, e.g. \"acme.com\" or \"stripe.io\""
    }
  },
  "required": [
    "domain"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user asks what a domain extension costs, where it is cheapest, or what it renews at. Returns dated first-year, renewal and transfer prices per registrar (Porkbun, Dynadot, Cloudflare, Namecheap where tracked), the cheapest direct buy, the wholesale floor, and a renewal-trap flag when the renewal is 2x+ the intro price. Prices are the TLD standard price, not premium names.

{
  "type": "object",
  "properties": {
    "tlds": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 63,
        "description": "A TLD without or with the dot, e.g. \"ai\" or \".io\""
      },
      "description": "TLDs to price, e.g. [\"com\", \"ai\", \"io\"]. Max 20."
    }
  },
  "required": [
    "tlds"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user asks what a domain extension is, what it means, who runs it, who can register it, or whether it fits their project ("is .ai good for a startup", "what is .io", "does .web exist"). Returns tld.expert’s editorial verdict, pros and cons, registry, registration restrictions, the use cases it ranks for, and a typical price. Also answers for well-known non-existent TLDs like .eth or .web.

{
  "type": "object",
  "properties": {
    "tld": {
      "type": "string",
      "minLength": 1,
      "maxLength": 63,
      "description": "A TLD without or with the dot, e.g. \"ai\" or \".io\""
    }
  },
  "required": [
    "tld"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}