Domain HTTP API

The domain search of the Domains page can be read from anywhere, such as a landing page with a domain checker, a pricing table or a script. It is a small, read-only API with two GET endpoints. There is no key and no sign in, any website can call it from the browser, and it answers with the prices a workspace pays. Every domain in an answer also carries a link that opens the Domains page with that domain searched, ready to buy.

The base address is https://api.modulify.ai/domains.

A service that needs DNS records on a domain bought here can hand its owner a link that fills them in for one-click approval, see Add records with a link.

Check a name

GET /availability checks whether domains are free and what they cost.

curl "https://api.modulify.ai/domains/availability?name=acme&tld=com"

With a bare name, it checks the extensions Modulify features, such as .com, .net, .org, .co, .io and .ai. With an extension, on name or in tld, it checks that domain first and the featured extensions after it. Modulify sells the extensions Name.com registers, apart from those whose registry needs extra details Modulify cannot collect yet, such as .us or .eu.

{
    "success": true,
    "message": "Domains were searched successfully.",
    "data": {
        "Label": "acme",
        "Requested": "acme.com",
        "UnsupportedTld": null,
        "Currency": "USD",
        "Results": [
            {
                "Name": "acme.com",
                "Tld": "com",
                "Available": false,
                "Premium": false,
                "PriceCents": null,
                "RenewalPriceCents": null,
                "Years": 1,
                "RenewalYears": 1,
                "Currency": "USD",
                "BuyUrl": "https://modulify.ai/dashboard/domains?name=acme&tld=com"
            },
            {
                "Name": "acme.studio",
                "Tld": "studio",
                "Available": true,
                "Premium": false,
                "PriceCents": 2999,
                "RenewalPriceCents": 3499,
                "Years": 1,
                "RenewalYears": 1,
                "Currency": "USD",
                "BuyUrl": "https://modulify.ai/dashboard/domains?name=acme&tld=studio"
            }
        ]
    },
    "code": 200
}

Treat a call as failed unless the HTTP status is ok and success is true, and read the answer from data. The envelope also carries version, the build of the API, which you can ignore.

Each entry in Results:

An answer can be up to 10 minutes old, so a domain registered a moment ago can still show as available, and the answer is sent with Cache-Control: public, max-age=60. The price is worked out again when someone buys the domain, so what they pay is current.

List prices

GET /prices lists what each extension costs.

curl "https://api.modulify.ai/domains/prices?tlds=com,io,ai"

Leave them all out to list every extension on sale. The list is sorted by extension, apart from featured=true, which lists the featured extensions in the order a bare name is checked against them, starting with com.

{
    "success": true,
    "message": "Domain prices were listed successfully.",
    "data": {
        "Currency": "USD",
        "Extensions": [
            {
                "Tld": "ai",
                "Featured": true,
                "Registration": { "PriceCents": 15998, "Years": 2 },
                "Renewal": { "PriceCents": 15998, "Years": 2 }
            },
            {
                "Tld": "com",
                "Featured": true,
                "Registration": { "PriceCents": 1299, "Years": 1 },
                "Renewal": { "PriceCents": 1499, "Years": 1 }
            }
        ]
    },
    "code": 200
}

These are the prices of an ordinary name. A premium name costs more, and only Check a name gives its price. An extension you ask for that is not on sale is left out of Extensions, and asking for a single one that is not on sale returns 404, for example .local domains are not for sale! The answer is sent with Cache-Control: public, max-age=300.

From a website

Both endpoints answer every origin, so a page can call them straight from the browser. They take GET only and never read cookies or credentials.

const CheckDomain = async (name) => {
    const response = await fetch(`https://api.modulify.ai/domains/availability?name=${encodeURIComponent(name)}`)
    const { success, data, message } = await response.json()

    if (!response.ok || !success) throw new Error(message)

    return data.Results.filter(result => result.PriceCents !== null)
}

Send people to a result's BuyUrl to buy it. Someone who is signed out signs in first, and the search runs once they are in.

Limits

Answers Modulify already holds cost nothing. Only lookups that have to ask Name.com count, toward 20 a minute from one network and 60 a minute shared by every caller. Past either, /availability answers 429 with a Retry-After header giving the seconds to wait, repeated in data.retryAfter. It answers the same way, with a wait of 60 seconds, while Name.com itself is too busy to answer. /prices never asks Name.com, so it has no limit.

Searches from the Domains page and from AI clients never use this allowance.

Errors

429, 502 and 503 are worth retrying after a pause. Never retry in a tight loop.