---
title: Public API documentation
description: Read the public domain catalog and search for names without an account
  or API key.
url: https://namegarage.com/docs/
---


# Public API documentation

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

- [Quickstart](https://namegarage.com/docs/quickstart): make your first HTTP request.
- [API reference](https://namegarage.com/developers/api/): browse request parameters and response schemas.
- [OpenAPI JSON](https://namegarage.com/openapi.json): the machine-readable specification.
- [Markdown documentation](https://namegarage.com/docs/index.md) and [Markdown quickstart](https://namegarage.com/docs/quickstart.md).
- [Full API documentation in one file](https://namegarage.com/llms-full.txt).

- [Connect an MCP client](https://namegarage.com/mcp/): 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](https://www.npmjs.com/package/@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](https://namegarage.com/docs/quickstart) and [source repository](https://github.com/namegarage/sdk).
You can also use an HTTP client or a compatible MCP client without installing a package.

- [API catalog](https://namegarage.com/.well-known/api-catalog)
- [Public agent guide](https://namegarage.com/AGENTS.md)
- [Agent Skills index](https://namegarage.com/.well-known/agent-skills/index.json)