Quickstart

Get up and running with RobotDomainSearch in under 5 minutes.

Make Your First Request

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

Response:

{
  "name": "myawesomestartup",
  "results": [
    {"domain": "myawesomestartup.com", "tld": "com", "available": true},
    {"domain": "myawesomestartup.io", "tld": "io", "available": true},
    {"domain": "myawesomestartup.dev", "tld": "dev", "available": false}
  ],
  "totalMs": 245,
  "timestamp": "2025-01-28T12:00:00Z"
}

That’s it! No API keys required for basic usage.

Understanding the Response

┌─────────────────────────────────────────────────────────────────┐
│  Field              │  Type     │  Description                 │
├─────────────────────────────────────────────────────────────────┤
│  name               │  string   │  Domain name that was checked│
│  results            │  array    │  Availability per TLD        │
│  results[].domain   │  string   │  Full domain name            │
│  results[].tld      │  string   │  Top-level domain            │
│  results[].available│  boolean  │  true if available           │
│  totalMs            │  number   │  Total check time (ms)       │
│  timestamp          │  string   │  ISO 8601 timestamp          │
└─────────────────────────────────────────────────────────────────┘

List Supported TLDs

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

Response:

{
  "count": 19,
  "tlds": [
    {"tld": "com", "type": "gTLD", "enabled": true},
    {"tld": "io", "type": "ccTLD", "enabled": true},
    {"tld": "ai", "type": "ccTLD", "enabled": true}
  ]
}

Check Health

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

Response:

{"status": "ok", "version": "0.1.0"}

Next Steps