{
  "openapi": "3.0.1",
  "info": {
    "title": "Bulk Domain Availability & Expiry Checker (RDAP)",
    "description": "Check thousands of domains for availability, expiry date, registrar, EPP status and nameservers via official registry RDAP (every RDAP TLD), with DNS fallback for ccTLDs. Name x TLD matrix for brand hunting and a monitor mode that outputs only changes.",
    "version": "0.1",
    "x-build-id": "QhRKjMNBr1ZVfWAi6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lindenbyte~bulk-domain-availability-expiry-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lindenbyte-bulk-domain-availability-expiry-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/lindenbyte~bulk-domain-availability-expiry-checker/runs": {
      "post": {
        "operationId": "runs-sync-lindenbyte-bulk-domain-availability-expiry-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/lindenbyte~bulk-domain-availability-expiry-checker/run-sync": {
      "post": {
        "operationId": "run-sync-lindenbyte-bulk-domain-availability-expiry-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",
            "type": "array",
            "description": "Domains to check, one per line. URLs and subdomains are accepted and reduced to the registrable domain (https://www.example.com/page -> example.com, blog.example.co.uk -> example.co.uk). International names (münchen.de) work too. Duplicates are removed.",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Name ideas (keyword x TLD matrix)",
            "type": "array",
            "description": "Optional. Brand or name ideas without extension (acme, my brand). Each keyword is checked in every TLD listed below, e.g. 2 keywords x 4 TLDs = 8 domains.",
            "items": {
              "type": "string"
            }
          },
          "tlds": {
            "title": "TLDs for the name ideas",
            "type": "array",
            "description": "Extensions to combine with the keywords (com, io, ai, dev, co.uk ...). Used only when keywords are given. If empty: com, net, org, io, ai, dev, app, co.",
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "check",
              "monitor"
            ],
            "type": "string",
            "description": "Monitor mode remembers each domain's availability, status, expiry date, registrar, nameservers and EPP status codes between runs (stored under the state key below) and outputs only the domains where something changed: a domain became available, was renewed or transferred, entered redemption, or entered your expiring window. Schedule it daily or weekly.",
            "default": "check"
          },
          "stateKey": {
            "title": "Monitor state key",
            "type": "string",
            "description": "Monitor mode only. Name of the saved watch list snapshot. Use a different key for each separate list you monitor (e.g. client-a, drop-watch).",
            "default": "default"
          },
          "outputBaseline": {
            "title": "Output all domains on the first monitor run",
            "type": "boolean",
            "description": "Monitor mode only. On the first run (no saved snapshot yet) every domain is output as change type 'new'. Turn off to only record the baseline silently; later runs output changes only.",
            "default": true
          },
          "expiringWithinDays": {
            "title": "Expiring within (days)",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Optional. Flags each registered domain with expiringSoon = true when its expiry date is within this many days. In monitor mode a domain entering this window is reported as a change."
          },
          "onlyExpiringSoon": {
            "title": "Output only domains expiring within the window",
            "type": "boolean",
            "description": "Requires 'Expiring within (days)'. Domains outside the window are checked but not output (and not charged).",
            "default": false
          },
          "includeDns": {
            "title": "Add DNS records (A, AAAA, MX, NS, SPF, DMARC)",
            "type": "boolean",
            "description": "For registered domains, also look up A, AAAA, MX, NS, the SPF record and the DMARC policy via public DNS-over-HTTPS. Charged as a separate small event per domain; skipped for available domains.",
            "default": false
          },
          "concurrency": {
            "title": "Parallel lookups",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many domains are checked at the same time. Requests to each registry are additionally spaced out and slowed down automatically when a registry rate-limits.",
            "default": 10
          },
          "maxDomains": {
            "title": "Max domains per run",
            "minimum": 1,
            "maximum": 200000,
            "type": "integer",
            "description": "Safety cap on the number of domains checked in one run (after the keyword x TLD matrix is expanded).",
            "default": 10000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}