Home

Awesome

<div align="center">

๐Ÿงช Next Whois UI

๐Ÿ˜Ž Lightweight & Beautiful Whois Query Tool

English | ็ฎ€ไฝ“ไธญๆ–‡

Deploy to Vercel

Deploy to Netlify

</div>

๐Ÿ˜Ž Features

No need to say more, just try it out! ๐Ÿฅณ

  1. โœจ Pretty UI: Modern design with Shadcn UI, make you feel comfortable.
  2. ๐Ÿ“ฑ Responsive: Works well on Mobileโœ… / Tabletโœ… / Desktopโœ…, PWA App Support.
  3. ๐ŸŒˆ Multi Theme: Multi theme support (Light & Dark), system theme detection, switch theme as you like.
  4. ๐Ÿš€ Flexible Query: Powered by Next.js, support serverless deployment and fast query.
  5. ๐Ÿ“š Record History: History records are stored in local storage, easy to view and query history.
  6. ๐Ÿ“ก Open API: Simple API for whois query, easy to integrate with other services.
  7. ๐ŸŒ IPv4 & IPv6 Whois: Support IPv4, IPv6, Domain, ASN, CIDR whois query.
  8. ๐Ÿ“ฆ Result Capture: Capture whois result, easy to share and save.
  9. ๐Ÿ“ก Whois Cache: Support whois cache based on Redis, improve query speed.
  10. ๐ŸŒ [WIP] Internationalization: Support multiple languages. (#6)

๐Ÿ‘‰ Create Pull Request

Deploy

1 ๐Ÿš€ Platforms (Recommended)

Vercel / Netlify / Zeabur

2 ๐Ÿณ Docker

docker run -d -p 3000:3000 programzmh/next-whois-ui

3 ๐Ÿ”จ Source Code

git clone https://github.com/zmh-program/next-whois-ui
cd next-whois-ui

npm install -g pnpm
pnpm install
pnpm dev

๐Ÿ“ Envs

SEO

WHOIS

CACHE

๐Ÿ“ API Reference

GET /api/lookup?query=google.com

<details> <summary><strong>Response</strong> OK (200)</summary>
{
  "time": 1.547,
  "status": true,
  "cached": false,
  "result": {
    "domain": "GOOGLE.COM",
    "registrar": "MarkMonitor Inc.",
    "registrarURL": "http://www.markmonitor.com",
    "ianaId": "292",
    "whoisServer": "whois.markmonitor.com",
    "updatedDate": "2019-09-09T15:39:04.000Z",
    "creationDate": "1997-09-15T04:00:00.000Z",
    "expirationDate": "2028-09-14T04:00:00.000Z",
    "status": [
      {
        "status": "clientDeleteProhibited",
        "url": "https://icann.org/epp#clientDeleteProhibited"
      },
      {
        "status": "clientTransferProhibited",
        "url": "https://icann.org/epp#clientTransferProhibited"
      },
      {
        "status": "clientUpdateProhibited",
        "url": "https://icann.org/epp#clientUpdateProhibited"
      },
      {
        "status": "serverDeleteProhibited",
        "url": "https://icann.org/epp#serverDeleteProhibited"
      },
      {
        "status": "serverTransferProhibited",
        "url": "https://icann.org/epp#serverTransferProhibited"
      },
      {
        "status": "serverUpdateProhibited",
        "url": "https://icann.org/epp#serverUpdateProhibited"
      }
    ],
    "nameServers": [
      "NS1.GOOGLE.COM",
      "NS2.GOOGLE.COM",
      "NS3.GOOGLE.COM",
      "NS4.GOOGLE.COM"
    ],
    "registrantOrganization": "Unknown",
    "registrantProvince": "Unknown",
    "registrantCountry": "Unknown",
    "registrantPhone": "+1 2086851750",
    "registrantEmail": "Unknown",
    "rawWhoisContent": "..."
  }
}
</details> <details> <summary><strong>Error Response</strong> Internal Server Error (500)</summary>
{
  "time": 0.609,
  "status": false,
  "error": "No match for domain google.notfound (e.g. domain is not registered)"
}
</details> <details> <summary><strong>Error Response</strong> Bad Request (400)</summary>
{
  "time": -1,
  "status": false,
  "error": "Query is required"
}
</details>

๐Ÿง  Tech Stack

๐Ÿ’ช TLDs Support

๐Ÿ‘‰ TLDs Whois Parser Lib Source Code

โค TIP: The Whois Parser for some TLDs may not be currently compatible, thanks for contributing your Pull Request to make this project support more TLDs!