rest api

Developer API.

Every Naymo capability as plain JSON — the same logic that powers the MCP server. No key required. CORS-enabled. Params via query string or JSON body. Base URL: https://naymo.ai.

Endpoints

Method	Path	Description
GET	/api/search?query=lumina&tlds=com,io,ai&years=3	Availability + cheapest registrar for a term (fanned across TLDs) or an exact domain.
GET	/api/check?domains=acme.com,acme.io	Registry-level availability for exact domains (bulk).
GET	/api/price?domain=acme.com&years=3	Cheapest registrar to register AND renew a domain, with multi-year TCO and deal score.
GET	/api/compare?tld=io&years=3	Full registrar price table for a TLD, cheapest-first.
GET	/api/suggest?query=coffee&tld=com&limit=12	Quick list of available name ideas with pricing.
POST	/api/brand	Business idea → ranked, available, scored brand names. Body: { idea, style?, tlds?, limit? }.

Example — cheapest registrar

curl -s 'https://naymo.ai/api/price?domain=acme.com&years=3' | jq

{
  "ok": true,
  "summary": "Cheapest registrars for acme.com over 3 years ...",
  "domain": "acme.com",
  "status": { "state": "taken", "summary": "Registered via ..." },
  "pricing": {
    "cheapestTco":   { "registrar": "Spaceship", "tco": 29.44, ... },
    "cheapestRenewal": { "registrar": "Spaceship", "renewal": 9.98 },
    "medianRenewal": 12.18,
    "dealScore": 57,
    "offers": [ ... ]
  }
}

Example — generate branding

curl -s https://naymo.ai/api/brand \
  -H 'content-type: application/json' \
  -d '{ "idea": "an AI code review tool for teams", "style": "techy", "limit": 8 }'

Notes

• Availability is real-time from authoritative sources with smart fallbacks — no false positives.
• Pricing is curated and renewal-aware; dealScore is 0–100 vs the market median.
• Responses include a human-readable summary and structured fields.

Use the MCP server →