API reference

Domain Suggestions API

Get AI-powered domain name suggestions based on your keywords, brand, or business description. Use this reference to choose an operation and integrate its documented response contract.

Operations

GET /v1/suggest View API reference

GET /v1/suggest

Operation: suggestDomains Credits and authentication: 2-5 Authentication required
GET /v1/suggest

Query Parameters

Parameter Type required
keywords string required
tlds string optional
style string
Allowed values brandablekeyword-richshortpronounceabletechyplayfulprofessionalminimal
Default brandable
optional
industry string
Allowed values techfinancehealthecommerceeducationmediasaascryptoaigaming
optional
language string
Allowed values enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe
Default en
optional
limit integer
Default 20
optional
check boolean
Default true
optional

Response Fields

Field Type
suggestions[] object[]
suggestions[] object
suggestions[].name string
suggestions[].domain string
suggestions[].tld string
suggestions[].score integer
suggestions[].available boolean | null
suggestions[].method string
keywords[] string[]
tlds[] string[]
styles[] string[]
industry string | null
language string
generated_count integer
available_count integer | null
generation_summary object
generation_summary.requested_limit integer
generation_summary.candidate_count integer
generation_summary.returned_count integer
generation_summary.availability_checked boolean
generation_summary.availability_check_count integer
generation_summary.available_count integer | null
generation_summary.tld_count integer
generation_summary.language string
generation_summary.method_counts object
generation_summary.style_counts object
generation_summary.top_method string | null
generation_summary.average_score integer | null
meta object
meta.total_generated integer
meta.available_count integer
meta.generation_ms integer

Example Request

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/suggest?keywords=crypto%2Cwallet%2Cfinance&tlds=com%2Cio&style=example.com&industry=example.com&language=es&limit=25&check=example.com"

Example Response

{
  "suggestions": [
    {
      "name": "string",
      "domain": "example.com",
      "tld": "com",
      "score": 1,
      "available": true,
      "method": "string"
    }
  ],
  "keywords": [
    "string"
  ],
  "tlds": [
    "string"
  ],
  "styles": [
    "string"
  ],
  "industry": "tech",
  "language": "string",
  "generated_count": 1,
  "available_count": 1,
  "generation_summary": {
    "requested_limit": 1,
    "candidate_count": "2026-04-15",
    "returned_count": 1,
    "availability_checked": true,
    "availability_check_count": 1,
    "available_count": 1,
    "tld_count": 1,
    "language": "string",
    "method_counts": {},
    "style_counts": {},
    "top_method": "string",
    "average_score": 1
  },
  "meta": {
    "total_generated": 1,
    "available_count": 1,
    "generation_ms": 1
  }
}

Reference resources