Documentation

Domainr API (deprecated)

Fastly update

Domainr joined Fastly in 2023, and the Domain Research API is now part of the Fastly API. These original Domainr API docs are now deprecated, though we are leaving them online for users who haven't migrated to the Fastly API yet.

Overview

The Domainr API lets you programmatically retrieve instant domain search results and availability status.

The API has three methods: search, status, and register, each of which responds to HTTP 1.1 or HTTP/2 GET requests. The API server will respond identically on port 80 (HTTP) and port 443 (HTTPS).

Endpoints

  • https://api.domainr.com (high-volume, enterprise usage)
  • https://domainr.p.rapidapi.com (free or lower-volume usage)

Authentication

The Domainr API requires authentication for all requests. RapidAPI (formerly Mashape) users will use your RapidAPI API key and the mashape-key query parameter to authenticate:

https://domainr.p.rapidapi.com/v2/status?mashape-key=${your_rapidapi_key}&domain=acmecoffee.shop

High-volume customers using the Domainr API directly, should authenticate with the client_id parameter:

https://api.domainr.com/v2/status?client_id=${client_id}&domain=acmecoffee.shop

Methods

  • /v2/search responds with domain search results, for a given query
  • /v2/status responds with domain status (availability) for a given domain
  • /v2/register responds with an HTTP redirect to a supporting registrar

API arguments should be URL-encoded UTF-8 strings in the query string.

API responses are in JSON (application/json). On success or failure, the server will respond with an appropriate HTTP response code (2xx, 4xx, 5xx).

Note: API methods are versioned; the current version is v2.

Examples

Request

/v2/search?client_id=${client_id}&query=acme%20cafe

Response

{
    "results": [
        {
            "domain": "acme.cafe",
            "host": "",
            "subdomain": "acme.",
            "zone": "cafe",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=acme.cafe&gl=US%2CSan+Francisco%2CUS-CA&registrar=&source="
        },
        {
            ...
        },
    ]
}

Status

Request

/v2/status?client_id=${client_id}&domain=acmecoffee.shop

Response

{
    "status": [
        {
            "domain": "acmecoffee.shop",
            "zone": "shop",
            "status": "undelegated inactive",
            "summary": "inactive"
        }
    ]
}

Usage Guidelines

The Domainr API lets you integrate domain search and availability into your projects. Using the API implies that you will adhere to the following requirements:

  • Don’t DOS or scrape data from our service. We ban abusers without notice.
  • Don’t use a client_id or RapidAPI keys from sites that aren’t yours.
  • Don’t front-run or anything similarly lame.
  • Don’t use undocumented API methods, as they are neither designed nor supported for third-party usage.

We’d love it if you give Domainr a shoutout in your site or app, such as “Powered by Domainr.” And if you build something with the Domainr API, let us know!