Namerbot API

Generate Domain Name Ideas

GET /api/generate

Uses AI to generate creative domain name ideas based on your description, then checks availability via RDAP. Returns only available domains with registration links.

Parameters

description (required) — What you're building and what kind of name you want. 10-1000 characters, URL-encoded.
tlds (required) — Comma-separated TLDs to check. Options: com, net, org, co, io, xyz, ai.

Example Request

GET https://namerbot.ai/api/generate?description=A+fitness+app+for+busy+parents&tlds=com,io,ai

Example with curl

curl -b cookies.txt -c cookies.txt \
  "https://namerbot.ai/api/generate?description=A+bakery+in+Brooklyn&tlds=com,io"

Use -c and -b to persist the cookie across requests so your credits are tracked.

Response (200)

{
  "results": [
    {
      "domain": "fitkick.com",
      "tld": "com",
      "available": true,
      "registerUrl": "https://www.namecheap.com/domains/registration/results/?domain=fitkick.com"
    },
    {
      "domain": "rushparent.io",
      "tld": "io",
      "available": true,
      "registerUrl": "https://www.namecheap.com/domains/registration/results/?domain=rushparent.io"
    }
  ],
  "meta": {
    "totalGenerated": 25,
    "totalAvailable": 12,
    "description": "A fitness app for busy parents...",
    "model": "sonnet",
    "creditsRemaining": { "free": 9, "paid": 0, "total": 9 }
  }
}

Credits

Each request uses one search credit (25 name-checks). Free tier: 10 searches (250 name-checks, powered by Claude Sonnet). Paid tier: powered by Claude Opus. Credits are tracked by cookie. If you receive a 402 response, you've used all your credits. Visit namerbot.ai in a browser to purchase more.

No Credits (402)

{
  "error": "no_credits",
  "message": "You've used all your free searches.",
  "upgrade": {
    "starter": { "price": "$2", "searches": 20, "url": "https://namerbot.ai/pricing" },
    "pro": { "price": "$10", "searches": 150, "url": "https://namerbot.ai/pricing" }
  }
}

Check Domain Availability

GET /api/check

Check if specific domains are available. Free, no auth, no credits consumed.

Single domain

GET https://namerbot.ai/api/check?domain=example.com

{ "domain": "example.com", "available": false, "checkedAt": "2026-03-11T20:30:00Z" }

Multiple domains (max 20)

GET https://namerbot.ai/api/check?domains=cool.com,cool.io,cool.ai

{
  "results": [
    { "domain": "cool.com", "available": false, "checkedAt": "..." },
    { "domain": "cool.io", "available": true, "registerUrl": "...", "checkedAt": "..." }
  ],
  "summary": { "total": 3, "available": 1, "unavailable": 2 }
}

Supported TLDs: .com, .net, .org, .co, .io, .xyz, .ai

Check Credits

GET /api/credits

{ "free": 7, "paid": 0, "total": 7 }

Service Discovery

GET /api

Returns JSON describing all available endpoints, parameters, and examples.

Errors

400	Bad request — invalid domain format, missing parameters, description too short/long
402	No credits remaining (generate endpoint only). Visit namerbot.ai to purchase more.
429	Rate limit exceeded
500	Internal server error

Rate Limits

/api/generate — 10 requests/minute per IP
/api/check — 30 requests/minute per IP