Find out where your domains live
Group your whole inventory by registrar, then list the domains with no transfer lock or an expiry in the next 90 days. One pass shows where everything is and what lapses next.
Loading
Send up to 100 domain names in one POST request and get the WHOIS record of each back in a single response: registrar, dates, name servers, status codes, contacts and the raw record, as JSON or XML. A name that cannot be looked up is reported on its own entry, so one bad domain never costs you the whole batch.
Free bulk WHOIS API credits: 10,000 on signup, no credit card. You pay only for successful lookups.
Overview
A bulk WHOIS lookup returns the registration records of many domains from one query, instead of one query per name. For each domain you get the registrar, the creation, update and expiry dates, the name servers, the status codes and the registrant details the record publishes.
This API takes the list in a single POST request, up to 100 domains at a time, and returns one record per domain in the same structure for every extension. If you have been running lists through a bulk WHOIS checker on a website, this is the same job from code, with results you can store, join to your own data and compare over time. It runs on the same endpoint as the Domain WHOIS Lookup API, which looks up one domain per GET request.
Quickstart
Send a list of domains to the endpoint and read one entry back for each. Edit the list and the code updates in every language.
Sign up for free. Your key and 10,000 credits are ready right away. No card needed.
One POST with a JSON body {"domainNames": [...]}. Up to 100 domains, as names or as URLs. Pass the key in the X-apiKey header.
Check status on each entry, then domain_registered. Add format=xml to the URL for XML.
Response
Every distinct domain you send gets its own entry in the bulk_whois_response array. Each entry says what happened to that domain, so a batch of 100 never comes back as all or nothing.
A registered entry has the same fields as a single lookup. For XML, add format=xml to the request URL.
Read the field-by-field schema in the API referenceGuide: handle failed and unregistered entries
Large lists
One request takes 100 domains, so a list of 10,000 is 100 requests sent one after another. Four things make a long list easy to run unattended.
Guide: run a list of any size and save it as CSVEntries do not come back in the order you sent them. Join each one to your list on domain_name. A URL comes back as its domain, and a name sent twice returns one entry.
An unsupported or invalid name is reported on its own entry and is not charged, so one bad name does not spoil the batch. The request returns 206 while any entry has failed.
Write each batch to disk before you send the next one. After a crash or a stop, start again at the first batch you did not save, so you never pay twice for the same domains.
Pick the fields you need, such as expiry_date, and append them to a CSV file or a database table as each batch arrives. There is no export step at the end.
Track changes
Renew before it lapses.
The domain moved to another registrar.
clienttransferprohibited is gone from domain_status.
Where the domain points has changed.
A name that was unregistered yesterday shows domain_registered: "yes" today.
For changes from before your first saved run, use the WHOIS History API.
Guide: compare two runs to catch changesUse cases
Group your whole inventory by registrar, then list the domains with no transfer lock or an expiry in the next 90 days. One pass shows where everything is and what lapses next.
Add registration date, registrar, name servers and abuse contact to every indicator in an alert list. Sort by newest, and group by name server to spot shared infrastructure. For the network behind a domain, use the IP WHOIS Lookup API.
Send lookalike candidates in batches and drop the unregistered ones. A recent registration date and an unrelated registrar put a domain on the takedown shortlist. To find the owner's other domains, use the Reverse WHOIS API.
Confirm that every domain a target says it owns is registered, who holds it and when it expires. The same pass helps vet a merchant's domains in onboarding.
Drop the domains that no longer exist and flag the ones registered days ago before a campaign goes out.
Add registration age, registrar, expiry and registrant country as new columns to customers, referrers or email senders, and join them on domain_name.
Paste up to 100 domains into the playground and read the records back.
Single and bulk
Bulk lookup is not a separate service. It is the endpoint behind the Domain WHOIS Lookup API, called with POST and a domainNames list instead of GET and a single domainName. The record in every entry is the same, so code written for one domain keeps working on a batch.
domainNamedomainNamesStart with the single lookup while you build around one domain, and switch to POST when the input becomes a list.
Bulk WHOIS API referencePricing
Free tier. Every new account gets 10,000 free credits, enough for about 555 domains. The grant is one-time and does not renew, and no credit card is required.
What a domain costs. A successful lookup costs 18 credits per domain, not per request. A domain that returns a record is charged, including a name that turns out to be unregistered. Entries with status: false cost nothing, and any credits already deducted for them are refunded. A batch of 100 costs up to 1,800 credits.
Track usage. Check your balance and consumption with the Credits Usage API.
Integrations
OpenAPI 3.1 for every live API, in JSON and YAML.
npm i @apifreaks/openapi-specsImport the endpoint and try it with your key.
Open the Postman collectionConnect any MCP-compatible client to live APIFreaks data.
npx -y @apifreaks/mcpLet an agent call the REST API directly, without MCP.
npx skills add https://github.com/api-freaks/af-agent-skills --skill apifreaks-platformView skill →A machine-readable index for crawlers and agents.
FAQ
status: false, a 403 and an error, and the rest return their records. The request itself returns 206 when any entry fails, so check each entry's status as well as the HTTP code. Failed entries are not charged. Every domain that returns a record costs 18 credits, an unregistered name included, so a batch of 100 with 3 unsupported names costs 1746 credits.registrant_contact, which come back as the registry or registrar publishes them, such as REDACTED FOR PRIVACY. The entry still succeeds, and the dates, registrar, abuse email and phone, name servers and EPP status codes stay available. That is enough for age checks, expiry tracking, lock checks and grouping by registrar or name server.10,000 free credits
Send 100 domains in one request and read the records back. No credit card required.
Need high volume or a custom plan? Talk to us
Price per 1,000 requests
N/A
monthly plan
N/A
yearly plan
import requestsimport jsonurl = "https://api.apifreaks.com/v2.0/domain/whois/live"payload = json.dumps({"domainNames":["microsoft.com","zzzz.local"]})headers = {'Content-Type': 'application/json','X-apiKey': 'YOUR_API_KEY'}response = requests.request("POST", url, headers=headers, data=payload)print(response.text)