domains.ideas.generate

Deterministically generate domain candidates and check availability. For brandable searches, use brandMultiplex to combine ordered phoneme or morpheme dimensions without materializing the full Cartesian product. For descriptive searches, prefer ranked DataForSEO keywordVariations; use llmVariations only when keyword data is unavailable. Exact and hyphenated patterns test each phrase both without and with hyphens across TLDs. Fails the whole request on any inconclusive or failed Dynadot check rather than reporting a false negative.

Safety and behavior

Property	Value
Read-only	Yes
Destructive	No
Idempotent	Yes
Uses external systems	Yes

Parameters

Name	Type	Required	Description
keywords	array	Yes	Core keywords extracted from product/tool description (e.g., ["task", "flow", "automate"])
keywordVariations	array	No	Current keyword variations from DataForSEO. When non-empty, these are ranked deterministically by search volume and used instead of LLM variations.
llmVariations	array	No	Fallback complete-name variations generated by the host LLM. Used only when keywordVariations and brandMultiplex are absent.
brandMultiplex	object	No	Deterministic brand generator. Multiplexes ordered dimensions, normalizes labels, filters by length, and deduplicates before TLD expansion.
tlds	array	No	TLDs to check (1-50; default: com, io, co, app, dev, ai)
patterns	array	No	Generation patterns: exact removes spaces, hyphenated preserves word boundaries, prefix and suffix add deterministic modifiers (default: all)
maxToCheck	number	No	Maximum domains to check for availability (default: 100)

Input schema

{
  "type": "object",
  "properties": {
    "keywords": {
      "minItems": 1,
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Core keywords extracted from product/tool description (e.g., [\"task\", \"flow\", \"automate\"])"
    },
    "keywordVariations": {
      "description": "Current keyword variations from DataForSEO. When non-empty, these are ranked deterministically by search volume and used instead of LLM variations.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string"
          },
          "searchVolume": {
            "type": "number",
            "minimum": 0
          }
        },
        "required": [
          "keyword"
        ]
      }
    },
    "llmVariations": {
      "description": "Fallback complete-name variations generated by the host LLM. Used only when keywordVariations and brandMultiplex are absent.",
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "brandMultiplex": {
      "description": "Deterministic brand generator. Multiplexes ordered dimensions, normalizes labels, filters by length, and deduplicates before TLD expansion.",
      "type": "object",
      "properties": {
        "dimensions": {
          "minItems": 2,
          "maxItems": 6,
          "type": "array",
          "items": {
            "minItems": 1,
            "maxItems": 50,
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": "Ordered phoneme or morpheme dimensions combined by Cartesian product."
        },
        "separator": {
          "type": "string",
          "enum": [
            "",
            "-"
          ]
        },
        "minLength": {
          "type": "integer",
          "minimum": 2,
          "maximum": 63
        },
        "maxLength": {
          "type": "integer",
          "minimum": 2,
          "maximum": 63
        }
      },
      "required": [
        "dimensions"
      ]
    },
    "tlds": {
      "description": "TLDs to check (1-50; default: com, io, co, app, dev, ai)",
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "patterns": {
      "description": "Generation patterns: exact removes spaces, hyphenated preserves word boundaries, prefix and suffix add deterministic modifiers (default: all)",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "exact",
          "hyphenated",
          "prefix",
          "suffix"
        ]
      }
    },
    "maxToCheck": {
      "description": "Maximum domains to check for availability (default: 100)",
      "type": "number",
      "minimum": 10,
      "maximum": 500
    }
  },
  "required": [
    "keywords"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean",
      "description": "Whether the requested operation completed successfully."
    },
    "data": {
      "description": "Structured operation result when success is true.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "error": {
      "description": "Structured failure details when success is false.",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "description": "Stable error category for programmatic handling."
        },
        "message": {
          "type": "string",
          "description": "Human-readable explanation of the failure."
        },
        "suggestions": {
          "description": "Suggested corrective actions, when available.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "validActions": {
          "description": "Allowed operation names when an unknown operation was requested.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "docsUrl": {
          "type": "string",
          "description": "Documentation URL relevant to the failed tool."
        }
      },
      "required": [
        "type",
        "message",
        "docsUrl"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "success"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}