v1

latestOpenAPI 3.0.0raw.githubusercontent.com2026-04-107095124.5 KB

Search endpoints

Retrieves list of domains based on query

This route retrieves a list of domains that match the query

get/search

Query parameters

namestring

Search by domain name

profile-requiredboolean

Whether domains need have a profile configured

reverse-resolution-requiredboolean

Whether domains need to have reverse resolution configured

Response

Search result values

addressstring

Wallet address that owns the domain

namestring

The domain name

avatarUrlstring

Path to the profile image

imageUrlstring

Direct path to profile image metadata URL, if available

imageTypestring

Defines the type of image represented by the URL - default, onChain, offChain

imagePathstring

Path to the profile image

linkUrlstring

Link to the domain resource

ownerAddressstring

Wallet address that owns the domain

Example response

[
  {
    "name": "brad.crypto",
    "avatarUrl": "https://api.unstoppabledomains.com/metadata/image-src/brad.crypto?withOverlay=false&ref=1/erc1155:0xc7e5e9434f4a71e6db978bd65b4d61d3593e5f27/14317",
    "imageUrl": "https://path.to/image",
    "imageType": "onChain",
    "imagePath": "https://api.unstoppabledomains.com/metadata/image-src/brad.crypto?withOverlay=false&ref=1/erc1155:0xc7e5e9434f4a71e6db978bd65b4d61d3593e5f27/14317",
    "linkUrl": "https://ud.me/brad.crypto",
    "market": {
      "price": 1000,
      "location": "primary"
    }
  }
]