Domain WHOIS Lookup

Scrape single-page in JavaScript template

A template for scraping data from a single web page in JavaScript (Node.js). The URL of the web page is passed in via input, which is defined by the input schema. The template uses the Axios client to get the HTML of the page and the Cheerio library to parse the data from it. The data are then stored in a dataset where you can easily access them.

The scraped data in this template are page headings but you can easily edit the code to scrape whatever you want from the page.

Included features

• Apify SDK - toolkit for building Actors
• Input schema - define and easily validate a schema for your Actor's input
• Dataset - store structured data where each object stored has the same attributes
• Axios client - promise-based HTTP Client for Node.js and the browser
• Cheerio - library for parsing and manipulating HTML and XML

How it works

1. Actor.getInput() gets the input where the page URL is defined

2. axios.get(url) fetches the page

3. cheerio.load(response.data) loads the page data and enables parsing the headings

4. This parses the headings from the page and here you can edit the code to parse whatever you need from the page

   $("h1, h2, h3, h4, h5, h6").each((_i, element) => {...});
   

5. Actor.pushData(headings) stores the headings in the dataset

Resources

• Web scraping in Node.js with Axios and Cheerio
• Web scraping with Cheerio in 2023
• Video tutorial on building a scraper using CheerioCrawler
• Written tutorial on building a scraper using CheerioCrawler
• Integration with Zapier, Make, Google Drive, and others
• Video guide on getting data using Apify API
• A short guide on how to build web scrapers using code templates:

Getting started

For complete information see this article. To run the Actor use the following command:

$apify run

Deploy to Apify

Connect Git repository to Apify

If you've created a Git repository for the project, you can easily connect to Apify:

1. Go to Actor creation page
2. Click on Link Git Repository button

Push project on your local machine to Apify

You can also deploy the project on your local machine to Apify without the need for the Git repository.

1. Log in to Apify. You will need to provide your Apify API Token to complete this action.

   $apify login
   

2. Deploy your Actor. This command will deploy and build the Actor on the Apify Platform. You can find your newly created Actor under Actors -> My Actors.

   $apify push
   

Documentation reference

To learn more about Apify and Actors, take a look at the following resources:

• Apify SDK for JavaScript documentation
• Apify SDK for Python documentation
• Apify Platform documentation
• Join our developer community on Discord

Input example

{
  "domains": [
    "google.com",
    "github.com"
  ]
}

All fields are described in the Input tab, and the same JSON works in the API and for AI agents.

How much does Domain WHOIS Lookup cost?

This Actor uses pay-per-event pricing: you pay only for what it delivers, and platform usage is included.

Event	Price
Result (one dataset item)	$0.002 each ($2.00 per 1,000)

Set Maximum cost per run in the run options to cap your spend; the Actor stops when the limit is reached. Check the Pricing tab for current prices and plan discounts.

Use Domain WHOIS Lookup with AI agents (MCP)

Give Claude, ChatGPT, Cursor, VS Code or any MCP client this Actor as a tool through the hosted Apify MCP server. The agent sees the input fields with descriptions and example values, runs the Actor, and reads the results.

MCP server URL (this Actor only):

https://mcp.apify.com/?tools=technicaldost/domain-whois-lookup

Claude Code:

$claude mcp add --transport http apify "https://mcp.apify.com/?tools=technicaldost/domain-whois-lookup" --header "Authorization: Bearer YOUR_APIFY_TOKEN"

Cursor, VS Code, Claude Desktop and other clients (mcp.json or the client's MCP settings):

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=technicaldost/domain-whois-lookup",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

Clients that support sign-in (such as Claude.ai connectors) can use the URL without a token and log in to Apify instead. Get your token in Apify Console → Settings → API & Integrations, or generate a ready config for your client at mcp.apify.com. In the agent the tool is named technicaldost--domain-whois-lookup; ask it, for example, to "run Domain WHOIS Lookup with {"domains": ["google.com", "github.com"]}".

AI agents without an Apify account can also run and pay for this Actor per request with x402 agentic payments.

Run Domain WHOIS Lookup via API

Run the Actor and get its results in one call (replace YOUR_APIFY_TOKEN):

curl -X POST "https://api.apify.com/v2/acts/technicaldost~domain-whois-lookup/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domains": ["google.com", "github.com"]}'

Python (pip install apify-client):

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("technicaldost/domain-whois-lookup").call(run_input={"domains": ["google.com", "github.com"]})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript / TypeScript (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('technicaldost/domain-whois-lookup').call({"domains": ["google.com", "github.com"]});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Long runs: start them with POST /v2/acts/technicaldost~domain-whois-lookup/runs and fetch the dataset when the run finishes, or receive a webhook.

Related Actors

• Domain Portfolio Monitor - Expiry & WHOIS Change Alerts — Watch your domains for approaching expiry, registrar transfers, nameserver changes and status flags. Uses open
• WHOIS Company Intelligence API — Combine public WHOIS/RDAP domain registration data with company website business metadata in one API call. Ide

FAQ

Can I use Domain WHOIS Lookup with AI agents like Claude or ChatGPT?

Yes. Connect the Apify MCP server with ?tools=technicaldost/domain-whois-lookup (see above) and the agent can run the Actor and read its results on its own.

Can I call Domain WHOIS Lookup from my own code?

Yes. Use the REST API, or the official Python and JavaScript clients shown above. Results are available as JSON, CSV, Excel, XML or HTML.

How do I run it on a schedule?

Save your input as a task in Apify Console and add a schedule (for example, daily). Use webhooks or integrations to send each run's results onward.

Is it legal to use this Actor?

It works with publicly available data. Make sure your use complies with the source website's terms and with data protection laws such as GDPR, especially for personal data.

Something doesn't work or I need a feature. What should I do?

Open an issue in the Issues tab on this Actor's page with an example input, and we'll look into it.