SearchCtrl+K

Domain Search with Suggestions API Reference

Check domain name availability and receive alternative domain name suggestions across a variety of TLDs and SLDs. Returns a list of domain names with their availability status.

GET

https://api.apifreaks.com/v1.0/domain/availability/suggestions

Test

The Domain Search with Suggestions API not only checks availability for the requested domain but also generates a list of alternative domain names. You can customize the number of suggestions using the count parameter, and choose the data source with the source parameter.

Getting Started

Authentication

Pass your API key as the apiKey parameter in every request.

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/domain/availability/suggestions?domain=google.com' \
  -H 'X-apiKey: API-KEY'

Response

{
  "domain_available_response": [
    {
      "domain": "jfreaks.dev",
      "domainAvailability": true
    },
    {
      "domain": "jfreaks.org",
      "domainAvailability": true
    },
    {
      "domain": "jfreaks.info",
      "domainAvailability": true
    },
    {
      "domain": "jfreaks.net",
      "domainAvailability": true
    },
    {
      "domain": "jfreaks.com",
      "domainAvailability": false
    }
  ]
}

API Request Parameters

The following parameters can be used in your API requests. All parameters are passed as query string parameters.

domainrequiredString

Domain name whose availability to check

sourceoptionalStringdefault: dns

Specify the data source for domain availability checks. Use "dns" for DNS-based lookups or "whois" for WHOIS-based lookups.

countoptionalIntegerdefault: 5

No. of suggestions required

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the domain availability array. See the response preview on the right for the full JSON structure.

domain_available_response

Arraymandatory

List of domain availability objects.

Each object in the domain_available_response array contains the following fields:

domain

Stringmandatory

Name of the suggested domain

domainAvailability

Booleanmandatory

True if available, false if not available

Error Status & Codes

The API uses standard HTTP status codes to indicate the success or failure of requests. For common status codes like 429 (Too Many Requests), refer to the general API documentation.

400

Please pass domain param correct value e.g. whoisfreaks.com, https://whoisfreaks.com, http://whoisfreaks.com [For Technical Support: support@whoisfreaks.com]