---
title: "Unified Domains"
method: POST
path: "/v1/domains"
tags: ["Unified APIs"]
---

# Unified Domains

`POST /v1/domains`

Domain discovery.

- **suggest-names**: brandable domain NAME ideas for a business, checked for availability + price,
  ranked by the search options.
- **suggest-extensions**: the EXTENSIONS (.coffee, .studio, ...) that fit the business, with why + price.
- **search-extensions**: one exact name checked across the extension catalog (plus the name read across
  the dot), filtered and ordered by the search options, paged 50 at a time.

`purpose` (website | cold | extra) is context for the two suggest modes and sets no options; `search_options` sets them
(priorities, the max_* limits, hacks, allow_premium), as the caller judges the company needs. The response
echoes the effective options (`search_options`, or `search_plan.search_options` for suggest-names).
- **check-availability**: availability for a list of full domains (name.ext).
- **pricing**: comparison price per extension.
- **tlds**: the full extension catalog, enriched.

## Request body

- DomainsRequest
  - `mode` string
  - `company_name` string, nullable
  - `description` string, nullable
  - `company_id` string, nullable
  - `purpose` string, nullable
  - `search_options` DomainSearchOptions — unresolved $ref
  - `focus` string, nullable
  - `query` string, nullable
  - `exact_extension` boolean
  - `offset` integer
  - `tlds` string[], nullable
  - `domains` string[], nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `fcd4ea70588a` — 1 info
  - added the new optional request property `search_options`
- **2026-08-29** `2e9e8abc82a5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api/changes/v1/domains/post.md)

---

[API](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api.md) · [All operations](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/suprsonic/apis/suprsonic-unified-agent-api/revisions/fcd4ea70588a?raw)