Documentation

Search

The search method performs a real-time query of the search term(s) against the known zone database, making recommendations, stemming, applying Unicode folding, IDN normalization, registrar supported-zone restrictions, and other refinements.

The server responds with a JSON object containing search result(s) or an error.

Search method responses do not include domain availability status.

Arguments

ParameterDescriptionExample
queryTerm(s) to search against (required).query=foo%20bar
locationOverride IP location detection for country-code zones, with a two-character country code (optional).location=de
registrarThe domain name of a specific registrar, for filtering results by zones supported by the registrar (optional).registrar=dnsimple.com
defaultsComma-separated list of default zones to include in the response (optional).defaults=club
keywordsBeta: Comma-separated list of keywords for seeding the results. For example, a new gTLD like kitchen, or a related keyword like vegan. Helpful for search result relevance (e.g. from a targeted ad click, a user profile, etc.). (optional).keywords=food,kitchen

Example

Request

/v2/search?query=foo%20bar&keywords=food,kitchen&defaults=club&registrar=dnsimple.com

Response

{
    "results": [
        {
            "domain": "foo.bar",
            "host": "",
            "subdomain": "foo.",
            "zone": "bar",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.bar&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.beer",
            "host": "",
            "subdomain": "foo.",
            "zone": "beer",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.beer&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.cafe",
            "host": "",
            "subdomain": "foobar.",
            "zone": "cafe",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.cafe&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.menu",
            "host": "",
            "subdomain": "foobar.",
            "zone": "menu",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.menu&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.kitchen",
            "host": "",
            "subdomain": "foobar.",
            "zone": "kitchen",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.kitchen&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.cafe",
            "host": "",
            "subdomain": "foo.",
            "zone": "cafe",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.cafe&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.pub",
            "host": "",
            "subdomain": "foo.",
            "zone": "pub",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.pub&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.club",
            "host": "",
            "subdomain": "foo.",
            "zone": "club",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.club&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.menu",
            "host": "",
            "subdomain": "foo.",
            "zone": "menu",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.menu&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foo.kitchen",
            "host": "",
            "subdomain": "foo.",
            "zone": "kitchen",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foo.kitchen&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.com",
            "host": "",
            "subdomain": "foobar.",
            "zone": "com",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.com&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.club",
            "host": "",
            "subdomain": "foobar.",
            "zone": "club",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.club&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.net",
            "host": "",
            "subdomain": "foobar.",
            "zone": "net",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.net&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.org",
            "host": "",
            "subdomain": "foobar.",
            "zone": "org",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.org&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.co",
            "host": "",
            "subdomain": "foobar.",
            "zone": "co",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.co&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.io",
            "host": "",
            "subdomain": "foobar.",
            "zone": "io",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.io&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        },
        {
            "domain": "foobar.us",
            "host": "",
            "subdomain": "foobar.",
            "zone": "us",
            "path": "",
            "registerURL": "https://api.domainr.com/v2/register?domain=foobar.us&gl=US%2CSan+Francisco%2CUS-CA&registrar=dnsimple.com&source="
        }
    ]
}