REST API

Hope Domain REST API

Powerful REST API for domain WHOIS queries, batch operations, and AI-driven domain recommendations. Integrate domain intelligence into your applications.

WHOIS Lookup
Query domain registration information and availability status
MethodGET
AuthenticationNone Required
Rate LimitFree
Batch WHOIS
Query multiple domains at once for efficient bulk operations
MethodPOST
AuthenticationRequired
Rate Limit≤50 Free
AI Domain Recommender
Get AI-powered domain suggestions based on project descriptions
MethodPOST
AuthenticationRequired
Rate Limit1-50 Credits

API Documentation

GET /api/whois/[domain]
免费
Query WHOIS information for a single domain. This endpoint is free and requires no authentication.

Parameters

domain (string, required) - The domain name to query (e.g., "example.com")

Request

GET /api/whois/example.com

Response

{ "result": true, "data": { "domain": "example.com", "status": "registered", "registrar": "Example Registrar" } }

Example

curl -X GET "https://hopedomain.com/api/whois/example.com"

Authentication

API Keys
Use API keys for programmatic access to all endpoints. Create and manage your API keys in the console.
Authorization: Bearer sk-your_api_key_here
🔑 API Key Required

All authenticated API endpoints require a valid API key. Please create your API key and include it in the request headers.

Create API Key

Error Codes

CodeMessageDescription
400Bad RequestThe request was malformed or contained invalid parameters
401UnauthorizedAuthentication is required or the provided credentials are invalid
403ForbiddenThe request is not allowed for the current user or API key
404Not FoundThe requested resource was not found
429Too Many RequestsRate limit exceeded. Please wait before making another request
500Internal Server ErrorAn unexpected error occurred on the server

Rate Limits

WHOIS API
Single domain WHOIS queries
Limit无限制
AuthNone
Batch WHOIS API
Multiple domain WHOIS queries
Limit≤50 免费
AuthRequired
AI Recommender API
AI-powered domain recommendations
Limit1-50 次
AuthRequired
Ready to Get Started?
Start integrating Hope Domain API into your applications today.