{
  "openapi": "3.0.1",
  "info": {
    "title": "Domain Availability Checker: Bulk WHOIS Lookup & Domain Age",
    "description": "Checks if each domain is available or taken; for taken names returns registration date, expiry, age and registrar from registry RDAP (WHOIS), DNS for .io/.de. Input: domain list, name ideas x endings, or dataset, CSV, Sheet. $0.005 per domain answered. Agent-ready via x402 and MCP.",
    "version": "0.1",
    "x-build-id": "jv2MFkhIa8XfwVe4j"
  },
  "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": {
          "domains": {
            "title": "Domains to check",
            "type": "array",
            "description": "Type or paste domains, one per line (for example example.com). Each comes back as available (not registered) or taken, with its registration date, expiry, age and registrar when taken. Leave empty to use 'Name ideas', a dataset, a file or Google Sheet instead.",
            "items": {
              "type": "string"
            }
          },
          "names": {
            "title": "Name ideas (checked with every ending below)",
            "type": "array",
            "description": "Brand or product name ideas without an ending, for example 'acmerobotics'. Each one is checked with every ending in 'Endings to check', so 3 names and 4 endings is 12 domains. Charged per domain checked.",
            "items": {
              "type": "string"
            }
          },
          "tlds": {
            "title": "Endings to check",
            "type": "array",
            "description": "The endings (top-level domains) to try for each name idea, for example com, io, ai, co, net, app. Defaults to com only. .uk is not checked (Nominet's terms).",
            "items": {
              "type": "string"
            }
          },
          "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.mozilla.org/en-GB/firefox/' is read as 'mozilla.org'. .uk domains are listed but not looked up (Nominet's terms do not permit commercial lookups) and are not charged."
          },
          "dnsFallback": {
            "title": "Use DNS for endings with no RDAP server (.io, .de, .ie...)",
            "type": "boolean",
            "description": "Some registries (.io, .de, .ie and others) run no RDAP server. With this on, public DNS answers whether those names are taken or almost certainly free (no dates). Charged like any other answer. Turn off to leave them as 'no_rdap_server', not charged.",
            "default": true
          },
          "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}