# 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
```

```json
{
    "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.