{ "openapi": "3.0.1", "info": { "title": "WHOIS Lookup & Domain Age Checker: Bulk Expiry, RDAP from CSV", "description": "Registration date, expiry, domain age, registrar and nameservers for every domain in an Apify dataset, CSV or Google Sheet, from the registries' own RDAP (WHOIS) servers. Keeps every original column. Inputs: datasetId or fileUrl, domainField. Charged per registry answer. Agent-ready: x402, MCP.", "version": "0.1", "x-build-id": "NFcDOK5LvZvON85NL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nerolabs~domain-whois-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nerolabs-domain-whois-checker", "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/nerolabs~domain-whois-checker/runs": { "post": { "operationId": "runs-sync-nerolabs-domain-whois-checker", "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/nerolabs~domain-whois-checker/run-sync": { "post": { "operationId": "run-sync-nerolabs-domain-whois-checker", "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": { "datasetId": { "title": "Dataset", "type": "string", "description": "An Apify dataset whose rows each hold a domain or website. Use the picker so the run is allowed to read it. Leave empty to use a file URL or inline data instead." }, "fileUrl": { "title": "File URL (CSV, Excel, JSON or Google Sheet)", "type": "string", "description": "A public link to a CSV, TSV, Excel (.xlsx), JSON or JSON Lines file, or a Google Sheet shared as 'anyone with the link'. Used when no dataset is set." }, "data": { "title": "Data (inline)", "type": "array", "description": "Rows as a JSON array, each with a domain or website field. Used when neither a dataset nor a file URL is set." }, "fileFormat": { "title": "File format", "enum": [ "auto", "csv", "tsv", "json", "jsonl", "xlsx" ], "type": "string", "description": "How to read the file URL. 'Detect automatically' works from the extension, the content type and the first bytes.", "default": "auto" }, "domainField": { "title": "Domain field", "type": "string", "description": "The column holding each domain, for example 'domain' or 'website'. Leave empty to detect it automatically. Full URLs, bare domains and even an email address all work: 'https://www.bbc.co.uk/news' is read as 'bbc.co.uk'." }, "keep": { "title": "Rows to keep", "enum": [ "all", "registered", "unregistered", "expiring", "new", "problems" ], "type": "string", "description": "Which rows end up in the results. Filtering happens after the lookup, so it does not change what a run costs.", "default": "all" }, "expiringWithinDays": { "title": "Expiring soon means within this many days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Sets the 'expiringSoon' column and the 'Expiring soon only' filter.", "default": 30 }, "newerThanDays": { "title": "Recently registered means within this many days", "minimum": 1, "maximum": 36500, "type": "integer", "description": "Sets the 'isNewDomain' column and the 'Recently registered only' filter. A domain registered a few months ago usually means a brand new business.", "default": 365 }, "includeRegistrantOrganization": { "title": "Include registrant organisation and country when published", "type": "boolean", "description": "Off by default. Most registries redact registrant details, and where they do publish something this Actor returns only an organisation name and a country code, never a person's name, email, phone or address.", "default": false }, "concurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many domains are looked up at once. Requests to any one registry are spaced out regardless, because registries rate-limit. Lower this if you see 'rate_limited' rows.", "default": 5 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one registry response before giving up on it.", "default": 20 }, "maxItems": { "title": "Max rows to check", "minimum": 1, "type": "integer", "description": "A safety cap on how many rows are read from the input. Leave empty for no cap (up to 50,000)." }, "exportFormats": { "title": "Also export a file", "uniqueItems": true, "type": "array", "description": "Optionally write the results as a real downloadable CSV and/or Excel file as well as the dataset.", "items": { "type": "string", "enum": [ "csv", "xlsx" ], "enumTitles": [ "CSV", "Excel (.xlsx)" ] } }, "outputDatasetName": { "title": "Append results to a named dataset", "type": "string", "description": "Optional. The name of a dataset to append every run's results to, so a scheduled run builds one growing table instead of a new dataset each time." }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional. When the run finishes, the summary (counts, top registrars, download links) is POSTed here as JSON, so a scheduled expiry watch can report into Slack, Zapier, Make, n8n or your own API." } } }, "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 } } } } } } } } } }