API Docs

curl "https://donadomains.xyz/api/search?q=donadomains"

const res = await fetch(
  "https://donadomains.xyz/api/search?q=donadomains"
);
const data = await res.json();

// Available domains with pricing
const available = data.results.filter(r => r.available);
console.log(`${available.length} domains available`);

// Cheapest option
const cheapest = available
  .flatMap(r => r.buyLinks ?? [])
  .find(l => l.isCheapest);
console.log(cheapest?.name, cheapest?.price);

{
  "keyword": "example",
  "tld": null,
  "results": [
    {
      "domain": "example.xyz",
      "available": true,
      "tld": ".xyz",
      "matchType": "exact",
      "buyLinks": [
        {
          "name": "Dynadot",
          "url": "https://dynadot.com/...",
          "price": "$13.17/yr",
          "priceNum": 13.17,
          "source": "scraped"
        },
        {
          "name": "GoDaddy",
          "url": "https://godaddy.com/...",
          "price": "$0.99/yr",
          "priceNum": 0.99,
          "isCheapest": true,
          "source": "scraped"
        }
      ],
      "registerUrl": "https://godaddy.com/..."
    },
    {
      "domain": "example.com",
      "available": false,
      "tld": ".com",
      "matchType": "exact",
      "buyLinks": []
    }
  ],
  "sources": [
    { "name": "Dynadot", "status": "ok", "count": 45, "durationMs": 6821 },
    { "name": "Name.com", "status": "ok", "count": 27, "durationMs": 8234 },
    { "name": "GoDaddy", "status": "ok", "count": 33, "durationMs": 12450 },
    { "name": "Namecheap", "status": "ok", "count": 6, "durationMs": 9102 },
    { "name": "Hover", "status": "ok", "count": 490, "durationMs": 11873 },
    { "name": "Porkbun", "status": "failed", "count": 0, "durationMs": 20000, "error": "timeout" }
  ]
}

curl -N "https://donadomains.xyz/api/search?q=donadomains&stream=true"

const res = await fetch(
  "https://donadomains.xyz/api/search?q=donadomains&stream=true"
);
const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });

  const parts = buffer.split("\n\n");
  buffer = parts.pop() ?? "";

  for (const part of parts) {
    const line = part.split("\n").find(l => l.startsWith("data: "));
    if (!line) continue;
    const event = JSON.parse(line.slice(6));

    if (event.type === "batch") {
      console.log(event.registrar, "done:", event.results.length, "results");
    } else if (event.type === "complete") {
      console.log("Search complete");
    }
  }
}