search

Get domain suggestions

Generate domain suggestions based on a search query. Supports pagination and optional parent domain filtering for third-level domain suggestions.

get/search/suggestions

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/search/suggestions
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

querystring required

Search query for domain suggestions

parentDomainstring

Optional parent domain for third-level domain suggestions

pageinteger

Page number for pagination (starts at 1)

pageSizeinteger

Number of results per page (1-100)

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Response

OK

domainsstring[] required
pagenumber required
totalPagesnumber required
nextPagenumber nullable required
pageSizenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.