# Domain WHOIS via RDAP: Clean Structured Records (`thoob/rdap-domain-lookup`) Actor Looks up domain registration data through official IANA RDAP servers (the structured-JSON successor to WHOIS): registrar, key dates, status codes, nameservers, DNSSEC, and abuse contact. Clean fields, no mangled WHOIS text. Billed only per resolved domain. - **URL**: https://apify.com/thoob/rdap-domain-lookup.md - **Developed by:** [Pono Data](https://apify.com/thoob) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $0.70 / 1,000 resolved domain records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Domain WHOIS via RDAP Look up domain registration data the modern way. RDAP is the official, structured-JSON successor to WHOIS, and IANA publishes which RDAP server is authoritative for each TLD. This actor reads that bootstrap registry, queries the right server per domain, and returns clean, consistent fields instead of the free-text WHOIS blobs the older scrapers mangle. For a TLD with no RDAP service it falls back to legacy WHOIS over port 43. ### What you get for each domain - Registration: registrar, registrar IANA ID, registrar URL, created / updated / expiration dates, status, nameservers, DNSSEC. - Derived signals: `domainAgeYears`, `expiresInDays` (a countdown, negative if past), and `transferLocked` (is the domain locked). - Contacts: registrant organization and country, the registrar abuse email, and the registrant / admin / tech contacts the registry publishes. ### Contacts and personal data Most individual registrant data is redacted by registries since 2018, and we pass through only what is published, never un-redacting anything. Personal contact fields (a person's name, email, phone, address) are returned **only for United States registrants**; for any other or unstated jurisdiction they are withheld and `personalDataStatus` says why. Organization, country, and the registrar abuse contact are not personal and ship for any domain. ### What this collects - What this collects: public domain registration records from RDAP and legacy WHOIS. - Source: public query protocols only. No logins, no paywalls, no access bypass. - Scope: personal contact fields are United States registrants only; non-personal registration data is global. - Billing: charged only on a resolved record; rejects are free. - Provenance: every row carries its source URL and retrieval time. ### Input - **Domains**: registered domains, one per line (`example.com`, `google.co.uk`). Pass the registered domain, not `www.` hosts or full URLs. - **Max delivered domains**: cap on resolved, billed rows (0 means no cap). - **Legacy WHOIS fallback**: for a TLD with no RDAP service, use port-43 WHOIS. On by default. ### How it works The correct RDAP server is resolved per TLD from the IANA bootstrap registry, so results are authoritative, not guessed. Every field is copied from the response; absent fields are null, never invented. A domain that returns not-found, or a TLD whose WHOIS publishes nothing usable, goes to the free `rejected` dataset and is not billed. Lookups run concurrently, so a batch stays fast. ### Billing Pay per resolved domain. Unresolvable domains, and TLDs that publish no data, cost nothing. ### Coverage Global for registration data. The one exclusion is jurisdictions under US sanctions (Cuba, Iran, North Korea, Syria, Russia, Belarus, Venezuela, Myanmar, matched by country-code TLD), which are written to the free `rejected` dataset and never billed. ### Opt out A domain owner can ask us to skip their domain at https://ponodata.com/opt-out . Suppressed domains are returned by nothing and never billed. ### Sample output A real run pulling registration data through official IANA RDAP servers: | domain | registrar | status | | --- | --- | --- | | google.com | MarkMonitor Inc. | client delete prohibited | | github.com | MarkMonitor Inc. | client delete prohibited | | stripe.com | SafeNames Ltd. | client delete prohibited | | apple.com | Nom-iq Ltd. dba COM LAUDE | client delete prohibited | Each row's `sourceUrl` is the RDAP query that returned it, for example `https://rdap.verisign.com/com/v1/domain/google.com`. ### See also More clean, pay-only-for-results data tools from Pono Data: - [Bulk DNS Lookup](https://apify.com/thoob/dns-bulk-lookup) - DNS records plus SPF, DMARC, and CAA - [Bulk Email Validator](https://apify.com/thoob/email-validator) - syntax, MX, disposable, and role flags - [URL Metadata & OpenGraph Extractor](https://apify.com/thoob/url-metadata-extractor) - title, OpenGraph, and meta tags per page Full catalog: https://apify.com/thoob # Actor input Schema ## `domains` (type: `array`): Registered domains to look up, one per line (for example example.com, google.co.uk). Pass the registered domain, not a host like www.example.com or a full URL. The correct RDAP server is found automatically per TLD from the official IANA bootstrap registry. ## `maxDomains` (type: `integer`): Safety cap on resolved and billed rows. 0 means no cap. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless. ## `whoisFallback` (type: `boolean`): For a TLD with no RDAP service, fall back to legacy WHOIS over port 43. Turn off for RDAP only. ## Actor input object example ```json { "domains": [ "example.com", "iana.org" ], "maxDomains": 0, "whoisFallback": true } ```` # Actor output Schema ## `records` (type: `string`): One row per resolved domain: registration data, contacts, and derived signals. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "domains": [ "example.com", "iana.org" ] }; // Run the Actor and wait for it to finish const run = await client.actor("thoob/rdap-domain-lookup").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "domains": [ "example.com", "iana.org", ] } # Run the Actor and wait for it to finish run = client.actor("thoob/rdap-domain-lookup").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "domains": [ "example.com", "iana.org" ] }' | apify call thoob/rdap-domain-lookup --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=thoob/rdap-domain-lookup", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Domain WHOIS via RDAP: Clean Structured Records", "description": "Looks up domain registration data through official IANA RDAP servers (the structured-JSON successor to WHOIS): registrar, key dates, status codes, nameservers, DNSSEC, and abuse contact. Clean fields, no mangled WHOIS text. Billed only per resolved domain.", "version": "0.0", "x-build-id": "8rf2MiruyhNDbgIkE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thoob~rdap-domain-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thoob-rdap-domain-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/thoob~rdap-domain-lookup/runs": { "post": { "operationId": "runs-sync-thoob-rdap-domain-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/thoob~rdap-domain-lookup/run-sync": { "post": { "operationId": "run-sync-thoob-rdap-domain-lookup", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "domains" ], "properties": { "domains": { "title": "Domains", "minItems": 1, "type": "array", "description": "Registered domains to look up, one per line (for example example.com, google.co.uk). Pass the registered domain, not a host like www.example.com or a full URL. The correct RDAP server is found automatically per TLD from the official IANA bootstrap registry.", "items": { "type": "string" } }, "maxDomains": { "title": "Max delivered domains", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Safety cap on resolved and billed rows. 0 means no cap. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless.", "default": 0 }, "whoisFallback": { "title": "Legacy WHOIS fallback", "type": "boolean", "description": "For a TLD with no RDAP service, fall back to legacy WHOIS over port 43. Turn off for RDAP only.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```