action cloudflare_registrar_domain_discovery_search {
  label: "Search for available domains"
  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"
  provider: cloudflare
  method: GET
  path: "/accounts/{account_id}/registrar/domain-search"
  encoding: json
  input: {
    type: "object"
    properties: {
      account_id: {
        type: "string"
        description: "Identifier"
      }
      extensions: {
        type: "array"
        items: {
          type: "string"
        }
      }
      limit: {
        type: "integer"
      }
      q: {
        type: "string"
      }
    }
    required: ["account_id", "q"]
    additionalProperties: false
  }
  output: {
    type: "object"
  }
}