---
title: "Check a domain and its alternate-TLD siblings"
method: POST
path: "/api/domain/search"
---

# Check a domain and its alternate-TLD siblings

`POST /api/domain/search`

## Request

- Base URL: `https://name.ai`
- URL: `https://name.ai/api/domain/search`
- Auth: one of:
  - none
  - OAuth 2 (authorization code, authorization URL `https://name.ai/oauth/authorize`, token URL `https://name.ai/api/oauth/token`, scopes: `pricing:read`)

Checks the given domain and, for a simple label.tld query, its common alternate TLDs (e.g. querying acme.com also returns acme.ai, acme.io, ...). Streams newline-delimited JSON (NDJSON): one 'header' event, then one 'row' event per domain, a 'primary_done' marker after the queried domain, and a final 'done' event. Buy-now/aftermarket prices are hidden unless the caller has a verified, signed-in session; new-registration pricing is always included.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `q` string, required: Domain to check, e.g. "example.ai".

## Response `200`

NDJSON stream of search events. Include a Bearer access token (scope pricing:read — see /AUTH.md) to unmask aftermarket/marketplace prices; omit it for the same response with those prices hidden. Deprecation/Sunset/Link headers appear only once the operation is deprecated (see x-deprecation-policy).

## Other responses

- `400`: q missing or not a valid domain.
- `429`: Per-IP limit exceeded (60 requests/minute).

---

[API](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1.md) · [All operations](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/llms.txt) · [OpenAPI document](https://skmtc.dev/name/apis/name-ai-api-public-rest-api-openapi-3-1/revisions/e04300069786?raw)