🔍Search

1. Search Suggestion and Prices

• GET /api/v1/white-label-logic/search

This endpoint allows users to search for available domain names and their corresponding pricing information based on the provided search string.

Query Parameters

Parameter	Type	Description
searchString	String	[Required] The desired domain name for which the user wants suggestions and prices.

Response

api/v1/white-label-logic/search?searchString=test.influencer

{
    "result": true,
    "data": {
        "result": [
            {
                "type": "EXACT_MATCH",
                "elements": [
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "398.90"
                        },
                        "url": "https://freename.io/results?search=%22test.influencer%22"
                    }
                ]
            },
            {
                "type": "SUGGESTED_TLD",
                "elements": [
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": ".question",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "299.00"
                        },
                        "url": "https://freename.io/results?search=%22.question%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": ".effect",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "399.00"
                        },
                        "url": "https://freename.io/results?search=%22.effect%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": ".essay",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "499.00"
                        },
                        "url": "https://freename.io/results?search=%22.essay%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": ".holistic",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "299.00"
                        },
                        "url": "https://freename.io/results?search=%22.holistic%22"
                    }
                ]
            },
            {
                "type": "SEARCH_STRING_AS_SECOND_LEVEL_DOMAIN",
                "elements": [
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.investigation",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "278.90"
                        },
                        "url": "https://freename.io/results?search=%22test.investigation%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.exam",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "199.90"
                        },
                        "url": "https://freename.io/results?search=%22test.exam%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.investigate",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "199.90"
                        },
                        "url": "https://freename.io/results?search=%22test.investigate%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.sinewy",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "598.90"
                        },
                        "url": "https://freename.io/results?search=%22test.sinewy%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "test.admirable",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "398.90"
                        },
                        "url": "https://freename.io/results?search=%22test.admirable%22"
                    }
                ]
            },
            {
                "type": "SECOND_LEVEL_DOMAIN_WITH_SEARCH_STRING_AS_TLD",
                "elements": [
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "reputable.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "209.00"
                        },
                        "url": "https://freename.io/results?search=%22reputable.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "ordeal.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "224.00"
                        },
                        "url": "https://freename.io/results?search=%22ordeal.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "authoritative.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "204.00"
                        },
                        "url": "https://freename.io/results?search=%22authoritative.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "important.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "498.00"
                        },
                        "url": "https://freename.io/results?search=%22important.influencer%22"
                    },
                    {
                        "availabilityStatus": "AVAILABLE",
                        "name": "investigation.influencer",
                        "price": {
                            "currency": "USD",
                            "valueFormatted": "204.00"
                        },
                        "url": "https://freename.io/results?search=%22investigation.influencer%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.