{ "openapi": "3.0.1", "info": { "title": "Bulk WHOIS Lookup & DNS Lookup - Domain Age & Expiry", "description": "Look up many domains at once: registrar, creation and expiry dates, status and name servers via RDAP (WHOIS fallback), availability, A/MX/NS/TXT/CAA records, SPF/DMARC grade. $2/1,000.", "version": "0.1", "x-build-id": "K5r10GsvmCTuuFagp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidytools~bulk-domain-whois-dns-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidytools-bulk-domain-whois-dns-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/tidytools~bulk-domain-whois-dns-lookup/runs": { "post": { "operationId": "runs-sync-tidytools-bulk-domain-whois-dns-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/tidytools~bulk-domain-whois-dns-lookup/run-sync": { "post": { "operationId": "run-sync-tidytools-bulk-domain-whois-dns-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", "properties": { "domains": { "title": "Domains", "type": "array", "description": "Main input (fill this, or `datasetId`). Domains, URLs or e-mail addresses, one per line (several per line separated by commas also work). Each is reduced to its registrable domain: https://www.bbc.co.uk/news → bbc.co.uk, _dmarc.github.com → github.com. The same domain is looked up and charged once. A line that is not a domain (e.g. a company name) is reported as one invalid row and not charged.", "items": { "type": "string" } }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Look up the domains in another Actor run's dataset, e.g. the website or email field of a lead list or contact scraper." }, "datasetField": { "title": "Dataset field", "type": "string", "description": "Field with the domain, URL or e-mail address, e.g. \"website\", \"domain\" or \"email\" (dot paths work). Empty = the first URL field found (url, website, link, domain...)." }, "includeRegistration": { "title": "Registration data (WHOIS / RDAP)", "type": "boolean", "description": "Registrar, creation, update and expiry dates, days to expiry, status codes, name servers, DNSSEC and the registrant organization and country when the registry publishes them.", "default": true }, "includeDns": { "title": "DNS records", "type": "boolean", "description": "A, AAAA, MX, NS, TXT and CAA records, the CNAME of www and the _dmarc record, read over DNS-over-HTTPS.", "default": true }, "emailSecurity": { "title": "E-mail security grade (SPF / DMARC / MX)", "type": "boolean", "description": "Parse SPF and DMARC and grade the domain A-F, with a list of issues. Needs DNS records. DKIM is not checked (it needs the sender's selector).", "default": true }, "checkAvailability": { "title": "Guess availability", "type": "boolean", "description": "Adds \"availability\": registered, likely_available (the registry has no record) or unknown, with a note. This is a guess: premium, reserved or blocked names can still be unavailable, so confirm with a registrar before you rely on it.", "default": false }, "maxConcurrency": { "title": "Parallel domains", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many domains are looked up at the same time. Requests to one registry are limited to 4 at a time whatever this is set to, to avoid rate limits.", "default": 10 }, "whoisFallback": { "title": "WHOIS fallback for TLDs without RDAP", "type": "boolean", "description": "Some country-code TLDs (.jp, .io, .co, .it, .eu, .cn, .ru, .kr, ...) have no RDAP server. With this on, their registry's classic WHOIS server (port 43) is asked instead and its text answer is parsed.", "default": true }, "followRegistrarRdap": { "title": "Ask the registrar's RDAP server for registrant details", "type": "boolean", "description": "For .com, .net and other registries that keep only basic data, ask the registrar's RDAP server for the registrant organization and country (one extra request per domain).", "default": true }, "proxyConfiguration": { "title": "Proxy (optional)", "type": "object", "description": "Only used for RDAP and DNS-over-HTTPS requests sent from Apify's network (not for port-43 WHOIS). Useful for very large lists if a registry rate-limits. Apify proxy usage is billed to your Apify account." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }