Search for available domains

client.Registrar.Search(ctx, params) (*RegistrarSearchResponse, error)

GET/accounts/{account_id}/registrar/domain-search

Searches for domain name suggestions based on a keyword, phrase, or partial domain name. Returns a list of potentially available domains with pricing information.

Important: Results are non-authoritative and based on cached data. Always use the /domain-check endpoint to verify real-time availability before attempting registration.

Suggestions are scoped to extensions supported for programmatic registration via this API (POST /registrations). Domains on unsupported extensions will not appear in results, even if they are available at the registry level.

Use cases

Brand name discovery (e.g., “acme corp” → acmecorp.com, acmecorp.dev)
Keyword-based suggestions (e.g., “coffee shop” → coffeeshop.com, mycoffeeshop.net)
Alternative extension discovery (e.g., “example.com” → example.com, example.app, example.xyz)

Workflow

Call this endpoint with a keyword or domain name.
Present suggestions to the user.
Call /domain-check with the user’s chosen domains to confirm real-time availability and pricing.
Proceed to POST /registrations only for supported non-premium domains where the Check response returns registrable: true.

Note: Searching with just a domain extension (e.g., “com” or “.app”) is not supported. Provide a keyword or domain name.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

ParametersExpand Collapse

params RegistrarSearchParams

AccountID param.Field[string]Optional

Path param: Identifier

maxLength32

Q param.Field[string]

Query param: The search term to find domain suggestions. Accepts keywords, phrases, or full domain names.

Phrases: “coffee shop” returns coffeeshop.com, mycoffeeshop.net, etc.
Domain names: “example.com” returns example.com and variations across extensions

maxLength100

minLength1

Extensions param.Field[[]string]Optional

Query param: Limits results to specific domain extensions from the supported set. If not specified, returns results across all supported extensions. Extensions not in the supported set are silently ignored.

Limit param.Field[int64]Optional

Query param: Maximum number of domain suggestions to return. Defaults to 20 if not specified.

maximum50

minimum1

ReturnsExpand Collapse

type RegistrarSearchResponse struct{…}

Contains the search results.

Domains []RegistrarSearchResponseDomain

Array of domain suggestions sorted by relevance. May be empty if no domains match the search criteria.

Name string

The fully qualified domain name (FQDN) in punycode format for internationalized domain names (IDNs).

Registrable bool

Indicates whether this domain appears available based on search data. Search results are non-authoritative and may be stale. - true: The domain appears available. Use POST /domain-check to confirm before registration.

false: The domain does not appear available in search results.

Pricing RegistrarSearchResponseDomainsPricingOptional

Annual pricing information for a registrable domain. This object is only present when registrable is true. All prices are per year and returned as strings to preserve decimal precision.

registration_cost and renewal_cost are frequently the same value, but may differ — especially for premium domains where registries set different rates for initial registration vs. renewal. For a multi-year registration (e.g., 4 years), the first year is charged at registration_cost and each subsequent year at renewal_cost. Registry pricing may change over time; the values returned here reflect the current registry rate. Premium pricing may be surfaced by Search and Check, but premium registration is not currently supported by this API.

Currency string

ISO-4217 currency code for the prices (e.g., “USD”, “EUR”, “GBP”).

RegistrationCost string

The first-year cost to register this domain. For premium domains (tier: premium), this price is set by the registry and may be significantly higher than standard pricing. For multi-year registrations, this cost applies to the first year only; subsequent years are charged at renewal_cost.

RenewalCost string

Per-year renewal cost for this domain. Applied to each year beyond the first year of a multi-year registration, and to each annual auto-renewal thereafter. May differ from registration_cost, especially for premium domains where initial registration often costs more than renewals.

Reason RegistrarSearchResponseDomainsReasonOptional

Present only when registrable is false on search results. Explains why the domain does not appear registrable through this API. These values are advisory; use POST /domain-check for authoritative status.

extension_not_supported_via_api: Cloudflare Registrar supports this extension in the dashboard but it is not yet available for programmatic registration via this API.
extension_not_supported: This extension is not supported by Cloudflare Registrar at all.
extension_disallows_registration: The extension’s registry has temporarily or permanently frozen new registrations.
domain_premium: The domain is premium priced. Premium registration is not currently supported by this API.
domain_unavailable: The domain appears unavailable.

One of the following:

const RegistrarSearchResponseDomainsReasonExtensionNotSupportedViaAPI RegistrarSearchResponseDomainsReason = "extension_not_supported_via_api"

const RegistrarSearchResponseDomainsReasonExtensionNotSupported RegistrarSearchResponseDomainsReason = "extension_not_supported"

const RegistrarSearchResponseDomainsReasonExtensionDisallowsRegistration RegistrarSearchResponseDomainsReason = "extension_disallows_registration"

const RegistrarSearchResponseDomainsReasonDomainPremium RegistrarSearchResponseDomainsReason = "domain_premium"

const RegistrarSearchResponseDomainsReasonDomainUnavailable RegistrarSearchResponseDomainsReason = "domain_unavailable"

Tier RegistrarSearchResponseDomainsTierOptional

The pricing tier for this domain. Always present when registrable is true; defaults to standard for most domains. May be absent when registrable is false.

standard: Standard registry pricing
premium: Premium domain with higher pricing set by the registry

One of the following:

const RegistrarSearchResponseDomainsTierStandard RegistrarSearchResponseDomainsTier = "standard"

const RegistrarSearchResponseDomainsTierPremium RegistrarSearchResponseDomainsTier = "premium"

Search for available domains

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/registrar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Registrar.Search(context.TODO(), registrar.RegistrarSearchParams{
    AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"),
    Q: cloudflare.F("x"),
  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Domains)
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "acmecorp.dev",
        "pricing": {
          "currency": "USD",
          "registration_cost": "10.11",
          "renewal_cost": "10.11"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "acmecorp.app",
        "pricing": {
          "currency": "USD",
          "registration_cost": "11.00",
          "renewal_cost": "11.00"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "bestpizza.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "bestpizza.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "bestpizzashop.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "coffeeshop.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "coffeeshoponline.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "mycoffeeshop.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "thecoffeeshop.shop",
        "pricing": {
          "currency": "USD",
          "registration_cost": "11.00",
          "renewal_cost": "11.00"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": []
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "crypto.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "100000.00",
          "renewal_cost": "5000.00"
        },
        "registrable": true,
        "tier": "premium"
      },
      {
        "name": "cryptotrading.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "mycrypto.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [
    {
      "code": 1002,
      "message": "Parameter q exceeds maximum length of 100 characters"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}

{
  "errors": [
    {
      "code": 1001,
      "message": "Missing required parameter: q"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}

Returns Examples

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "acmecorp.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "acmecorp.dev",
        "pricing": {
          "currency": "USD",
          "registration_cost": "10.11",
          "renewal_cost": "10.11"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "acmecorp.app",
        "pricing": {
          "currency": "USD",
          "registration_cost": "11.00",
          "renewal_cost": "11.00"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "bestpizza.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "bestpizza.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "bestpizzashop.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "coffeeshop.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "coffeeshoponline.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "mycoffeeshop.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "thecoffeeshop.shop",
        "pricing": {
          "currency": "USD",
          "registration_cost": "11.00",
          "renewal_cost": "11.00"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": []
  },
  "success": true
}

{
  "errors": [],
  "messages": [],
  "result": {
    "domains": [
      {
        "name": "crypto.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "100000.00",
          "renewal_cost": "5000.00"
        },
        "registrable": true,
        "tier": "premium"
      },
      {
        "name": "cryptotrading.com",
        "pricing": {
          "currency": "USD",
          "registration_cost": "8.57",
          "renewal_cost": "8.57"
        },
        "registrable": true,
        "tier": "standard"
      },
      {
        "name": "mycrypto.net",
        "pricing": {
          "currency": "USD",
          "registration_cost": "9.95",
          "renewal_cost": "9.95"
        },
        "registrable": true,
        "tier": "standard"
      }
    ]
  },
  "success": true
}

{
  "errors": [
    {
      "code": 1002,
      "message": "Parameter q exceeds maximum length of 100 characters"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}

{
  "errors": [
    {
      "code": 1001,
      "message": "Missing required parameter: q"
    }
  ],
  "messages": [],
  "result": null,
  "success": false
}