Dokumentacja dla deweloperów

Sugestie domen

DomScan API do analizy domen: Otrzymuj zasilane sztuczną inteligencją sugestie nazw domen na podstawie słów kluczowych, marki lub opisu biznesu.

Sugestie domen

Otrzymuj zasilane sztuczną inteligencją sugestie nazw domen na podstawie słów kluczowych, marki lub opisu biznesu.

GET /v1/suggest

Parametry zapytania

Parametr	Typ	Opis
keywords wymagane	string	Słowa kluczowe oddzielone przecinkami, np. "tech,cloud"
limit opcjonalne	number	Maksymalna liczba sugestii, domyślnie 20, maksymalnie 100
tlds opcjonalne	string	TLD do użycia, domyślnie: "com,ai,app"
style opcjonalne	string Dozwolone wartości `brandablekeyword-richshortpronounceabletechyplayfulprofessionalminimal` Domyślnie `brandable`	Styl: markowy, krótki, bogaty w słowa kluczowe, łatwy do wymówienia
industry opcjonalne	string Dozwolone wartości `techfinancehealthecommerceeducationmediasaascryptoaigaming`	Dodaje prefiksy i sufiksy specyficzne dla branży do wygenerowanych kandydatów.
language opcjonalne	string Dozwolone wartości `enzhesjadefrptitkoruarhibnidmsthvitrplnlsvdanofielcshuroukhe` Domyślnie `en`	Generuje prefiksy i sufiksy dla wybranego języka wraz z domyślnymi wartościami angielskimi.
check opcjonalne	boolean Dozwolone wartości `truefalse` Domyślnie `true`	Ustaw na false, aby pominąć wyszukiwanie dostępności i zwrócić tylko wygenerowane nazwy.

Przykład Request

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable"

const domscanFetch = (url, options = {}) =>
  fetch(url, {
    ...options,
    headers: { ...options.headers, "X-API-Key": "your-api-key" },
  });

const params = new URLSearchParams({
keywords: "cloud,sync",
limit: "10",
style: "brandable"
});
const response = await domscanFetch("https://domscan.net/v1/suggest?" + params);
console.log(await response.json());

import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

params = {"keywords": "cloud,sync", "limit": 10, "style": "brandable"}
data = domscan.get("https://domscan.net/v1/suggest", params=params).json()
print(data["suggestions"])

package main

import (
  "encoding/json"
  "fmt"
  "net/http"
  "os"
)

func domscanGet(url string) (*http.Response, error) {
  request, err := http.NewRequest(http.MethodGet, url, nil)
  if err != nil {
    return nil, err
  }
  request.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))
  return http.DefaultClient.Do(request)
}

func main() {
  url := "https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable"
  resp, _ := domscanGet(url)
  defer resp.Body.Close()

  var data map[string]any
  json.NewDecoder(resp.Body).Decode(&data)
  fmt.Println(data["suggestions"])
}

require 'net/http'
require 'json'

uri = URI("https://domscan.net/v1/suggest?keywords=cloud,sync&limit=10&style=brandable")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")
response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(request) }
data = JSON.parse(response.body)
puts data["suggestions"]

Example Odpowiedź

{
                "suggestions": [
                {
                "name": "cloudsync",
                "domain": "cloudsync.io",
                "tld": "io",
                "score": 95,
                "styles": ["brandable", "pronounceable"],
                "method": "combination",
                "available": true
                }
                ],
                "keywords": ["cloud", "sync"],
                "generated_count": 10,
                "available_count": 4
                }

Odpowiedź Fields

Pole	Typ
`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