Developer Manual

WHOIS API Reference & Integration Guide

Integrate our cheap, parsed WHOIS API into your applications in minutes. Copy-paste snippets in Python, JavaScript/Node.js, PHP, Go, and Ruby, or query via standard cURL.

Authentication

Authorization Headers & Base URL

All requests to our API require an active API key authorized via Bearer headers.

Base Endpoint URL

POST https://api.getwhoisdata.com/api/v1/whois

HTTP Headers

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
Accept: application/json

Rate Limits

Concurrency limits and 429 responses

Understand connection thresholds and how to write resilient retry loops.

By default, each API token allows up to 100 queries per second (QPS). If your servers launch concurrent batches exceeding this quota, the API will throttle incoming requests and respond with an HTTP 429 Too Many Requests status code.

We recommend implementing an **exponential backoff retry algorithm** inside your request hooks, checking for 429 codes, and delaying query retries by 100ms-500ms to protect endpoints from consecutive failures.

Query Parameters

RequestBody schema

The simple JSON body schema required for domain lookups.

Field	Type	Description
domain	String	Required. The domain name to query (e.g. `google.com`)
format	String	Optional. Either `json` or `csv`. Defaults to `json`

Popular Developer Resources

Integration Console

Interactive Code Snippets & Response Sandbox

Switch languages to check syntax libraries, modify formats, and review the JSON response schema.

EndpointPOST

https://api.getwhoisdata.com/api/v1/whois

# Real-time parsed domain lookup -> JSON
curl -X POST "https://api.getwhoisdata.com/api/v1/whois" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"domain": "test.com"}'

Need API Credits?

GetWhoisData operates a transparent, pay-as-you-go credit billing model at just $2 per 1,000 queries. Credits never expire and only deduct upon successful WHOIS resolution.

Get API Token Learn about API features

Start downloading the whois database today

Subscribe and your FTP credentials are delivered instantly. Daily files, unlimited downloads, no long-term contract.

Subscribe Now Access Data

Keep exploring

Explore the whois database

Everything you need to evaluate, buy and use our daily whois data.