Documentation / Endpoints / API overview

Domain search REST API reference

Six GET endpoints on one base address, answering in JSON. No key, no header and no sign-up: call it from a terminal, a server or a web page.

Base address

Every call is HTTPS and answers in JSON. Browsers on any site may call it: cross-origin requests are allowed.

Endpoints

Answers

A success has data (a list or one object) and meta (count, timing and notes). A refusal has error instead. The HTTP status always matches.

{
    "data": [],
    "meta": {
        "count": 0,
        "took_ms": 120
    }
}

{
    "error": {
        "code": "unknown_parameter",
        "message": "Unknown parameter: tld. This endpoint takes: name, tlds.",
        "docs": "https://domainmcp.net/documentation"
    }
}

Parameters

Descriptions

openapi.json describes every endpoint for code generators and API tools. manual.md is this whole documentation as one Markdown file.