WHOIS.LS

WHOIS.LS API Documentation

Our free WHOIS API allows you to integrate domain lookup functionality into your applications with no usage limits. Just like our web service, the API is 100% free, privacy-focused, and does not store any query data.

1. Base API Endpoint

Raw Text ( Default )

https://whois.ls/{domain}

JSON

https://whois.ls/json/{domain}

2. Main API Endpoint (Recommend)

JSON

https://api.whois.ls/?domain={domain}

3. Request Method

GET/POST

4. Request Parameters in URL

Parameter	Required	Type	Description
domain	Yes	String	Domain name to lookup (e.g. example.com, test.io)

5. Request Examples

5.1. Basic Request (Text Response)

curl "https://whois.ls/example.com"

5.2. Request with JSON Response

curl "https://whois.ls/json/example.com"

6. Response Examples

6.1. Text Response (Default)

Domain Name: EXAMPLE.COM
Registry Domain ID: 2336799_DOMAIN_COM-VRSN
Registrar WHOIS Server: whois.iana.org
Registrar URL: http://res-dom.iana.org
Updated Date: 2024-08-14T07:07:27Z
Creation Date: 1995-08-14T04:00:00Z
Registry Expiry Date: 2025-08-13T04:00:00Z
...
		

6.2. JSON Response

{
  "error": "false",
  "data": "Domain Name: EXAMPLE.COM\r\n   Registry Domain ID: 2336799_DOMAIN_COM-VRSN\r\n   Registrar WHOIS Server: whois.iana.org\r\nRegistrar URL: http://res-dom.iana.org\r\n   ..."
}
		

7. Error Responses

{
  "error": "true",
  "data": "Domain Not Supported or Not Valid"
}
		

8. Usage Guidelines

No Rate Limits - We do not impose any rate limits on API requests
No API Keys Required - Our API is completely open and does not require authentication
All API queries are processed in real-time and no data is stored (consistent with our privacy policy)
We recommend adding a reasonable delay between requests to respect target WHOIS servers
API response time depends on the target registry's WHOIS server speed (typically 1-5 seconds)

9. Supported TLDs

Our API supports over 100 TLDs including: .com, .org, .net, .io, .xyz, .app, .us, .uk, .de, .fr, .jp, .au, .ca, and many more. For a full list of supported TLDs, contact our support team.

10. Support & Contact

If you have questions about API usage, encounter technical issues, or need additional features, please contact just email us at: feedback@whois.ls.

Note: Our API commitment to being free and privacy-focused will never change - we will never charge for API access or store your query data.