POST /v1/domains/check

Check whether a domain is available to register through Warpweb, and what it costs. Returns availability + price for the requested domain plus a few related suggestions (name variations, regional variants).

Cost: Free.

Request

curl -X POST https://api.warpweb.ai/v1/domains/check \
  -H "Authorization: Bearer wwk_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "brooksideplumbing.com",
    "city": "austin",
    "industry": "plumbing"
  }'

Body

Field	Type	Required	Description
`domain`	string	yes	The domain to check, including TLD.
`city`	string	no	Biases suggestions toward regional variants (e.g. `brooksideplumbingaustin.com`).
`industry`	string	no	Biases suggestions toward industry-related variants.

Response

{
  "domain": "brooksideplumbing.com",
  "available": true,
  "price_cents": 1099,
  "suggestions": [
    {
      "domain": "brooksideplumbingaustin.com",
      "available": true,
      "price_cents": 999
    },
    {
      "domain": "brooksideplumbingtx.com",
      "available": true,
      "price_cents": 999
    }
  ]
}

When taken:

{
  "domain": "google.com",
  "available": false,
  "suggestions": [
    { "domain": "googleplumbing.com", "available": true, "price_cents": 1099 }
  ]
}

Fields

Field	Description
`available`	`true` if registerable through Warpweb, `false` if taken.
`price_cents`	All-in registration cost in USD cents. Pass this exact value to `POST /v1/domains/register`.
`suggestions`	A few related domains that are likely available. Each carries its own price.

Errors

Status	Body	Cause
400	`{ "error": "domain is required" }`	Missing `domain` field.
400	`{ "error": "..." }`	Domain string is malformed.

If the TLD isn’t supported by Warpweb’s registrar, you can still attach an externally-registered domain via POST /v1/sites/:id/domains.

DELETE /v1/sites/:id/domains/:domain POST /v1/domains/register