---

API Reference

Base URL: https://api.robotdomainsearch.com

Endpoints Overview

Endpoint	Method	Description
/check	GET	Check domain availability across multiple TLDs
/tlds	GET	List supported TLDs
/health	GET	Service health check

---

Check Domain Availability

GET /check

Check if a domain name is available for registration across all supported TLDs.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Domain name to check (without TLD)

Example Request

Terminal

curl "https://api.robotdomainsearch.com/check?name=example"

Response

{
  "name": "example",
  "results": [
    {
      "domain": "example.com",
      "tld": "com",
      "available": false,
      "status": ["active"],
      "premium": false,
      "source": "dns",
      "checkedAt": "2025-01-28T12:00:00Z",
      "responseMs": 45
    },
    {
      "domain": "example.io",
      "tld": "io",
      "available": true,
      "status": ["undelegated", "inactive"],
      "premium": false,
      "source": "rdap",
      "checkedAt": "2025-01-28T12:00:00Z",
      "responseMs": 320
    }
  ],
  "totalMs": 365,
  "timestamp": "2025-01-28T12:00:00Z"
}

Response Fields

Field	Type	Description
name	string	The domain name checked (without TLD)
results	array	Array of availability results per TLD
results[].domain	string	Full domain name
results[].tld	string	Top-level domain
results[].available	boolean	true if available, false if taken
results[].status	array	Domain status flags
results[].premium	boolean	Whether this is a premium domain
results[].source	string	Check method (dns or rdap)
results[].checkedAt	string	ISO 8601 timestamp
results[].responseMs	number	Response time in milliseconds
totalMs	number	Total time for all checks
timestamp	string	Request timestamp

---

List Supported TLDs

GET /tlds

Get a list of all supported top-level domains.

Example Request

Terminal

curl "https://api.robotdomainsearch.com/tlds"

Response

{
  "count": 19,
  "tlds": [
    {
      "tld": "com",
      "type": "gTLD",
      "rdapServer": "rdap.verisign.com/com/v1",
      "enabled": true
    },
    {
      "tld": "io",
      "type": "ccTLD",
      "rdapServer": "rdap.identitydigital.services/rdap",
      "enabled": true
    }
  ]
}

Response Fields

Field	Type	Description
count	number	Total number of supported TLDs
tlds	array	List of TLD configurations
tlds[].tld	string	TLD extension
tlds[].type	string	TLD type (gTLD or ccTLD)
tlds[].rdapServer	string	RDAP server URL
tlds[].enabled	boolean	Whether the TLD is active

---

Health Check

GET /health

Check if the API service is running.

Example Request

Terminal

curl "https://api.robotdomainsearch.com/health"

Response

{
  "status": "ok",
  "version": "0.1.0",
  "tlds": ["com", "io", "ai", "..."],
  "cacheStats": {
    "size": 19
  }
}

---

Error Responses

400 Bad Request

Returned when required parameters are missing.

{
  "error": "Missing required parameter: name"
}

500 Internal Server Error

Returned when the service encounters an error.

{
  "error": "Internal server error"
}

---

Rate Limits

During the beta period, there are no rate limits. We reserve the right to introduce rate limiting in the future to ensure fair usage.

CORS

The API supports CORS and can be called directly from browser-based applications.

---