{
  "openapi": "3.1.0",
  "info": {
    "title": "TLDMint Live Domain Generator & Availability API",
    "version": "1.0.0",
    "description": "Free, zero-auth API for AI agents, Custom GPTs, and developers to brainstorm niche domain names, verify real-time DNS availability, and retrieve verified first-year registration discounts."
  },
  "servers": [
    {
      "url": "https://tldmint.com",
      "description": "Production Edge API"
    }
  ],
  "paths": {
    "/api/generate": {
      "get": {
        "operationId": "generateAvailableDomains",
        "summary": "Generate domain ideas in 16 specialized modes and check live DNS availability",
        "parameters": [
          {
            "name": "mode",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "personal-email",
                "newsletter",
                "homelab",
                "portfolio",
                "five-letter",
                "two-word",
                "domain-hack",
                "combiner",
                "saas-ai",
                "ecommerce-store",
                "agency",
                "creator-bio",
                "podcast",
                "one-word",
                "under-1-dollar",
                "bulk-checker"
              ],
              "default": "saas-ai"
            },
            "description": "Niche domain generation mode"
          },
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Primary keyword, brand seed, or first name"
          },
          {
            "name": "q2",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional secondary word, craft, or last name"
          },
          {
            "name": "availableOnly",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": true
            },
            "description": "Filter to only unregistered/available domains"
          }
        ],
        "responses": {
          "200": {
            "description": "Generated domain list with live DNS availability and registerUrl links"
          }
        }
      }
    },
    "/api/check": {
      "get": {
        "operationId": "checkBulkDomainAvailability",
        "summary": "Check live DNS availability for up to 50 comma-separated domain names",
        "parameters": [
          {
            "name": "domains",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated domain names (e.g. vexlo.com,orbitlab.xyz)"
          }
        ],
        "responses": {
          "200": {
            "description": "Live availability status and registration checkout URLs"
          }
        }
      }
    },
    "/api/coupons": {
      "get": {
        "operationId": "getVerifiedNamecheapCoupons",
        "summary": "List active verified promo codes for domains, hosting, WordPress, Private Email, and VPN",
        "parameters": [
          {
            "name": "category",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "domains",
                "wordpress",
                "hosting",
                "email-ssl",
                "vpn"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Active verified promo codes and direct activation links"
          }
        }
      }
    }
  }
}