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.

Servers

https://api.cloudflare.com/client/v4

Path parameters

Name	Type	Required	Description
`account_id`	String	Yes	Cloudflare account ID. Required for all Registrar API operations.

Query parameters

Name Type Required Description

Name	Type	Required	Description
`limit`	Integer	No	Maximum number of domain suggestions to return. Defaults to 20 if not specified. Default value: 20
`q`	String	Yes	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
`extensions[]`	Array	No	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

Integer

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

Default value: 20

q

String

Yes

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

extensions[]

Array

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.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.