🔍Search

1. Search Suggestion and Prices

• GET /api/v1/reseller-logic/search

This endpoint allows users to search for available domain names and their corresponding pricing information based on the provided search string. It supports searching with multiple parameters.

Query Parameters

Parameter	Type	Description
searchString	String	[Required] The names of the desired domains for which the user would like suggestions and prices. Please note: the domain names must be separated by a single whitespace. See the example below.

Response

api/v1/reseller-logic/search?searchString=test.influencer ciao.influencer abc.influencer

{
    "result": true,
    "data": {
        "result": [
            {
                "type": "EXACT_MATCH",
                "elements": [
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.influencer",
                        "asciiName": "test.influencer",
                        "type": "SECOND_LEVEL_DOMAIN",
                        "level": "STANDARD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "995",
                            "valueFormatted": "995.00",
                            "amount": 995.0
                        },
                        "detailedTld": {
                            "isTldOwned": true,
                            "asciiName": "influencer",
                            "name": ".influencer"
                        },
                        "domainPrice": {
                            "currency": "USD",
                            "valueStringed": "995",
                            "valueFormatted": "995.00",
                            "amount": 995.0
                        },
                        "url": "https://freename.io/results?search=%22test.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "ciao.influencer",
                        "asciiName": "ciao.influencer",
                        "type": "SECOND_LEVEL_DOMAIN",
                        "level": "STANDARD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "199.9",
                            "valueFormatted": "199.90",
                            "amount": 199.9
                        },
                        "detailedTld": {
                            "isTldOwned": true,
                            "asciiName": "influencer",
                            "name": ".influencer"
                        },
                        "domainPrice": {
                            "currency": "USD",
                            "valueStringed": "199.9",
                            "valueFormatted": "199.90",
                            "amount": 199.9
                        },
                        "url": "https://freename.io/results?search=%22ciao.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "abc.influencer",
                        "asciiName": "abc.influencer",
                        "type": "SECOND_LEVEL_DOMAIN",
                        "level": "STANDARD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "499",
                            "valueFormatted": "499.00",
                            "amount": 499.0
                        },
                        "detailedTld": {
                            "isTldOwned": true,
                            "asciiName": "influencer",
                            "name": ".influencer"
                        },
                        "domainPrice": {
                            "currency": "USD",
                            "valueStringed": "499",
                            "valueFormatted": "499.00",
                            "amount": 499.0
                        },
                        "url": "https://freename.io/results?search=%22abc.influencer%22"
                    }
                ]
            },
            {
                "type": "SUGGESTED_TLD",
                "elements": [
                    {
                        "availabilityStatus": "PROTECTED",
                        "name": ".dunne",
                        "asciiName": "dunne",
                        "level": "STANDARD",
                        "type": "TLD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "699",
                            "valueFormatted": "699.00",
                            "amount": 699.0
                        },
                        "url": "https://freename.io/results?search=%22.dunne%22"
                    },
                    {
                        "availabilityStatus": "PROTECTED",
                        "name": ".memphis",
                        "asciiName": "memphis",
                        "level": "STANDARD",
                        "type": "TLD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "4099",
                            "valueFormatted": "4,099.00",
                            "amount": 4099.0
                        },
                        "url": "https://freename.io/results?search=%22.memphis%22"
                    },
                    {
                        "availabilityStatus": "PROTECTED",
                        "name": ".justice",
                        "asciiName": "justice",
                        "level": "STANDARD",
                        "type": "TLD",
                        "price": null,
                        "url": "https://freename.io/results?search=%22.justice%22"
                    },
                    {
                        "availabilityStatus": "PROTECTED",
                        "name": ".defi247",
                        "asciiName": "defi247",
                        "level": "STANDARD",
                        "type": "TLD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "79",
                            "valueFormatted": "79.00",
                            "amount": 79.0
                        },
                        "url": "https://freename.io/results?search=%22.defi247%22"
                    },
                    {
                        "availabilityStatus": "PROTECTED",
                        "name": ".metasell",
                        "asciiName": "metasell",
                        "level": "STANDARD",
                        "type": "TLD",
                        "price": {
                            "currency": "USD",
                            "valueStringed": "1488",
                            "valueFormatted": "1,488.00",
                            "amount": 1488.0
                        },
                        "url": "https://freename.io/results?search=%22.metasell%22"
                    }
                ]
            }
        ],
        "errors": []
    }
}

Response Structure:

• result: Indicates whether the search was successful.

• data: Contains the search results.

  • result: Contains different types of search results.

    • type: Type of search result.

    • elements: List of elements corresponding to the search result type.

      • availabilityStatus: Availability status of the domain.

      • name: Domain name.

      • asciiName: ASCII representation of the domain name.

      • type: Type of domain.

      • level: Domain level.

      • price: Pricing information for the domain.

        • currency: Currency of the price.

        • valueStringed: Price in string format.

        • valueFormatted: Price in formatted string format.

        • amount: Price in numerical format.

      • detailedTld: Detailed information about the top-level domain.

        • isTldOwned: Indicates whether the top-level domain is owned.

        • asciiName: ASCII representation of the top-level domain.

        • name: Name of the top-level domain.

      • domainPrice: Pricing information specific to the domain.

        • currency: Currency of the price.

        • valueStringed: Price in string format.

        • valueFormatted: Price in formatted string format.

        • amount: Price in numerical format.

      • url: URL to view more details about the domain.