Skip to main content
GET
MetaSearch domain search
Returns a ranked set of available domains for a search term: the exact-match domain, available alternatives, and (optionally) AI-generated brandable suggestions, each with ready-to-display pricing. How it works: Pass a search_term: either a bare name (coffee) or a full domain including a TLD (coffee.com). The response leads with a featured result (type: "hero"), followed by the results list, and (when enabled) a trailing block of AI-suggested names. Every item carries a live available flag and a pricing object (null when the domain is taken). Suggestions: Set autosuggest=true and MetaSearch automatically suggests additional available names (close variations around your search term) in the results list. Set aisuggest=true and it appends a block of AI-suggested, brandable names (each type: "ai_suggestion"). Both are off by default; enable either or both. Pricing: Each available result includes a pricing object with the registration and renewal price, an is_free_first_year flag, and a ready-to-display summary string (e.g. "1st Year Free, then $9.99/yr"). Prices are scoped to your partner account’s catalogue. The searched domain: When the search includes a TLD (e.g. coffee.com), the row matching that exact domain is flagged with is_searched_exact: true, so you can highlight “the domain you searched,” whether it’s available or taken.

Authorizations

Authorization
string
header
required

Your partner API key. Include it in the Authorization header as Bearer <token>. Unauthenticated requests return 401 Unauthorized.

Query Parameters

search_term
string
required

The name to search: either a bare label (coffee) or a full domain including a TLD (coffee.com). Include a TLD to search that exact domain; the matching row is returned flagged is_searched_exact: true. Maximum 63 characters.

Example:

"coffee"

autosuggest
boolean
default:false

When true, MetaSearch automatically suggests additional available names (close variations coined around your search_term) and folds them into the results list alongside the exact match. Defaults to false.

Example:

true

aisuggest
boolean
default:false

When true, MetaSearch appends a block of AI-suggested names: brandable, model-coined alternatives to your search_term, each returned with type: "ai_suggestion". Independent of autosuggest; defaults to false.

Example:

true

Response

Ranked search results with live availability and pricing.

results
object[]

The full result set, in render order: the hero first (when present), then the results list, then any AI-suggested names. Never paginated.

results_total
integer

Total number of results-list items.

results_hidden
integer

Results-list items beyond the first 10 (use to drive a "show more" affordance).

message
string

Present only when there are no results (e.g. "No results for this name").

meta
object