Public API documentation

Use Namegarage's public interfaces to find domains for sale and check their current prices.

Quickstart: make your first HTTP request.
API reference: browse request parameters and response schemas.
OpenAPI JSON: the machine-readable specification.
Markdown documentation and Markdown quickstart.
Full API documentation in one file.
Connect an MCP client: use the same catalog through two read-only tools.

Authentication

No authentication is required. You do not need an account, API key, bearer token, or browser cookie. The OpenAPI reference declares an empty security requirement.

Choose no authentication when connecting an MCP client.

These public interfaces cannot sign in, create accounts, send messages, reserve names, or make purchases. Other website endpoints serve private or interactive flows. Do not call them as catalog APIs.

Available interfaces

GET /domains.json returns the published catalog as JSON. Its domains array contains public listings.
GET /api/search searches by project description or keywords. The required q parameter is 2–200 characters.
POST /api/mcp supports remote Streamable HTTP clients. Its tools are search_domains and get_domain.

Search accepts max_price in whole USD, tier, tld, max_length, and limit from 1 to 50. See the OpenAPI reference for types, defaults, and error responses.

Prices and availability

Search results include the current price in price_usd. A null price means offer-only, not free. Catalog rows use buy_now and may include time-bound promotion data; search resolves the current price for you. Follow the returned domain-page URL before making a decision. A result does not reserve the name.

An MCP lookup returning found: false means the name is absent from this public catalog.

Absence from the catalog does not establish whether a name is registered or available elsewhere.

Limits and errors

Search and MCP share a request allowance per IP address. For HTTP 429 or 503, pause and honor Retry-After. If no retry time is provided, use increasing delays.

MCP tool errors can also provide retry_after_seconds.

HTTP 400 identifies an invalid parameter. Correct it before retrying. A response with meaning: "unavailable" can still contain keyword matches; do not describe those as semantic matches.

SDKs and discovery

The official JavaScript and TypeScript client is @namegarage/sdk. Version 0.1.0 supports catalog reads and search, ESM and CommonJS, and browser bundles with no runtime dependencies. See the SDK quickstart and source repository. You can also use an HTTP client or a compatible MCP client without installing a package.