{"command":{"effect":"read","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Searches for domain name suggestions based on a keyword, phrase, or partial domain name.\nReturns a list of potentially available domains with pricing information.\n\n**Important:** Results are non-authoritative and based on cached data. Always use the\n`/domain-check` endpoint to verify real-time availability before attempting registration.\n\nSuggestions are scoped to extensions supported for programmatic registration\nvia this API (`POST /registrations`). Domains on unsupported extensions will\nnot appear in results, even if they are available at the registry level.\n\n### Use cases\n- Brand name discovery (e.g., \"acme corp\" → acmecorp.com, acmecorp.dev)\n- Keyword-based suggestions (e.g., \"coffee shop\" → coffeeshop.com, mycoffeeshop.net)\n- Alternative extension discovery (e.g., \"example.com\" → example.com, example.app, example.xyz)\n\n### Workflow\n1. Call this endpoint with a keyword or domain name.\n2. Present suggestions to the user.\n3. Call `/domain-check` with the user's chosen domains to confirm real-time availability and pricing.\n4. Proceed to `POST /registrations` only for supported non-premium domains\n   where the Check response returns `registrable: true`.\n\n**Note:** Searching with just a domain extension (e.g., \"com\" or \".app\") is not supported. Provide a keyword or domain name.\n","properties":{"path":{"type":"object","properties":{"account_id":{"$ref":"#/definitions/registrar-api_identifier","description":"Cloudflare account ID. Required for all Registrar API operations."}},"required":["account_id"],"additionalProperties":false},"query":{"type":"object","properties":{"q":{"type":"string","maxLength":100,"minLength":1,"examples":["coffee shop"],"description":"The search term to find domain suggestions. Accepts keywords, phrases, or full domain names.\n- Phrases: \"coffee shop\" returns coffeeshop.com, mycoffeeshop.net, etc.\n- Domain names: \"example.com\" returns example.com and variations across extensions\n"},"extensions":{"type":"array","items":{"type":"string"},"maxItems":20,"examples":[["com","net","org"]],"description":"Limits results to specific domain extensions from the supported set. If not specified,\nreturns results across all supported extensions. Extensions not in the supported\nset are silently ignored.\n"},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"examples":[20],"description":"Maximum number of domain suggestions to return. Defaults to 20 if not specified.\n"}},"required":["q"],"additionalProperties":false}},"required":["path","query"],"additionalProperties":false,"definitions":{"registrar-api_identifier":{"description":"Identifier.","type":"string","maxLength":32,"examples":["023e105f4ecef8ad9ca31a8372d0c353"]}}},"name":"Search for available domains","id":"cloudflare.registrar-domain-discovery-search","example":{"path":{"account_id":"023e105f4ecef8ad9ca31a8372d0c353"},"query":{"q":"coffee shop"}},"maxRequests":1,"summary":false}}