Domain Whois

Domain WHOIS Information Lookup
Look up WHOIS registration data for a domain name.

Method: GET
Path: /v1/websitetools/whois
Demo: https://api.gugudata.io/v1/websitetools/whois/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

• appkey (string, required): Application key used for request authentication. Supply the value as a query parameter, form field, or multipart field according to the request content type.
• domain (string, required): Domain name or HTTPS origin to inspect.

Response Fields:

• dataStatus.requestParameter (string, required): Normalized request parameters echoed by the service. Sensitive credentials are omitted when available.
• dataStatus.statusCode (integer, required): Application-level status code returned by the current v1 contract.
• dataStatus.status (string, required): Application-level status enum returned by the current v1 contract.
• dataStatus.statusDescription (string, required): Application-level status message returned by the current v1 contract.
• dataStatus.responseDateTime (string, required): Response timestamp returned by the current service contract.
• dataStatus.dataTotalCount (integer, required): Total number of records that match the request.
• data.domain_name (array, required): Domain name(s) found in WHOIS record
• data.registrar (string, required): Domain registrar information
• data.creation_date (array, required): Domain creation date(s)
• data.expiration_date (array, required): Domain expiration date(s)
• data.updated_date (array, required): Domain last update date(s)
• data.name_servers (array, required): Domain nameservers
• data.status (array, required): Domain status information
• data.org (string, optional): Organization name
• data.country (string, optional): Country code
• data.emails (array, optional): Contact email addresses
• data.dnssec (string, optional): DNSSEC status

HTTP Status Codes:

• 200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.
• 400: Invalid request parameters or request format. Check required fields, data types, and request body format.
• 401: Missing or unknown application key. Provide a valid appkey with the request.
• 403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.
• 429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.
• 500: Internal service error. Retry later or contact support if the error persists.
• 503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

• 200 Normal return: WHOIS information successfully retrieved
• 400 Parameter error: Invalid domain name or missing required parameters
• 429 Request frequency limited: Cannot exceed 100 requests per second
• 403 Account in arrears: Payment required to continue using the service
• 402 APPKEY error: Please check whether the APPKEY passed is obtained from the developer center
• 500 API response error: Internal server error during WHOIS lookup
• 503 Service unavailable: WHOIS service temporarily unavailable

Key Features:

• Comprehensive WHOIS information lookup for any domain.
• Detailed domain registration and expiration information.
• Nameserver and DNS information retrieval.
• Domain status and security information.
• Registrar and organization details.
• Contact information and email addresses.
• Full API support for HTTPS (TLS v1.0 / v1.1 / v1.2 / v1.3).
• Fully compatible with Apple ATS.
• Nationwide multi-node CDN deployment.
• Ultra-fast response, API interface load balancing built with multiple servers.

Details:
https://gugudata.io/details/whois