{
  "openapi": "3.0.1",
  "info": {
    "title": "Domain Reputation Checker: RDAP Lookup, DNS, SPF & DMARC",
    "description": "Check domain reputation and email authentication in bulk: RDAP lookup (WHOIS alternative), DNS, SPF, DMARC, DNSSEC, TLS and a phishing risk score from real registry data. Monitor expiry and DNS changes. Outputs domain records (JSON, CSV) and an HTML report. Works as an AI agent / MCP tool.",
    "version": "1.0",
    "x-build-id": "e3b3QwLc15NLZzfP6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/j0l30~domain-rdap-dns-reputation-checker/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-j0l30-domain-rdap-dns-reputation-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/j0l30~domain-rdap-dns-reputation-checker/runs": {
      "post": {
        "operationId": "runs-sync-j0l30-domain-rdap-dns-reputation-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/j0l30~domain-rdap-dns-reputation-checker/run-sync": {
      "post": {
        "operationId": "run-sync-j0l30-domain-rdap-dns-reputation-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "check",
              "monitor",
              "availability"
            ],
            "type": "string",
            "description": "What to run: check = full report per domain; monitor = same, plus a saved snapshot per domain and alerts (expiry, DNS/NS/MX changes, certificate expiring, risk jump); availability = cheap RDAP lookup of names you list in candidates or generate from keywords. Example: check",
            "default": "check"
          },
          "domains": {
            "title": "Domains (check and monitor)",
            "type": "array",
            "description": "For check and monitor: up to 1,000 domains or URLs. Subdomains are reduced to the registrable domain (shop.example.co.uk → example.co.uk). Duplicates are removed and invalid entries are listed but not charged. Example: [\"example.com\", \"iana.org\"]",
            "items": {
              "type": "string"
            }
          },
          "brandKeywords": {
            "title": "Brand keywords to protect",
            "type": "array",
            "description": "Optional: your brand names. Domains that contain them, sit 1-2 letters away, or use lookalike characters are flagged as possible typosquats or phishing. Example: [\"paypal\"]",
            "items": {
              "type": "string"
            }
          },
          "ownedDomains": {
            "title": "Your own domains",
            "type": "array",
            "description": "Optional: domains you own. They are never flagged for your brand keywords. Example: [\"paypal.com\"]",
            "items": {
              "type": "string"
            }
          },
          "checkDns": {
            "title": "DNS checks (A/AAAA, MX, NS, TXT, SPF, DMARC, DNSSEC, CAA)",
            "type": "boolean",
            "description": "true = look up A, AAAA, MX, NS, TXT (SPF), DMARC, CAA and DNSSEC through public DNS-over-HTTPS resolvers (Cloudflare, then Google). Example: true",
            "default": true
          },
          "checkTls": {
            "title": "TLS certificate (direct handshake)",
            "type": "boolean",
            "description": "true = connect to port 443 once to read the certificate issuer, validity and days left. Example: true",
            "default": true
          },
          "checkHttp": {
            "title": "Homepage HTTP check",
            "type": "boolean",
            "description": "true = one request to http:// and its redirects (at least 1 s apart per host): HTTPS redirect, HSTS, security headers, login form. Only the homepage is read. Example: true",
            "default": true
          },
          "checkCertTransparency": {
            "title": "Certificate Transparency (crt.sh)",
            "type": "boolean",
            "description": "true = count unexpired certificates and hostnames seen in public CT logs (crt.sh, a free and slow community service; 3 s between requests, failures tolerated). Best for small lists. Example: false",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "For monitor mode: named key-value store in your Apify account that keeps one snapshot per domain between runs. Use a different name per watch list. Example: domain-monitor",
            "default": "domain-monitor"
          },
          "expiryAlertDays": {
            "title": "Alert when the domain expires within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "For monitor mode: raise expiry_soon when the registry expiry date is this many days away or less. Example: 30",
            "default": 30
          },
          "certAlertDays": {
            "title": "Alert when the TLS certificate expires within (days)",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "For monitor mode: raise cert_expiring when the TLS certificate ends within this many days. Example: 14",
            "default": 14
          },
          "riskJumpAlert": {
            "title": "Alert when risk score rises by at least",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "For monitor mode: raise risk_jump when the risk score rises by this much since the last run. Example: 15",
            "default": 15
          },
          "candidates": {
            "title": "Candidate domains",
            "type": "array",
            "description": "For availability mode: full domain names to check. Example: [\"lycorax.com\", \"lycorax.app\"]",
            "items": {
              "type": "string"
            }
          },
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "For availability mode: each keyword is combined with every TLD in tlds (and prefixes/suffixes). \"argan oil\" gives arganoil.com and argan-oil.com. Example: [\"argan oil\"]",
            "items": {
              "type": "string"
            }
          },
          "tlds": {
            "title": "TLDs",
            "type": "array",
            "description": "For availability mode: TLDs to combine with keywords. Some TLDs (e.g. .io, .co, .de, .ma) publish no RDAP: they are marked unknown, with a DNS hint. Example: [\"com\", \"net\", \"org\", \"app\", \"dev\"]",
            "default": [
              "com",
              "net",
              "org",
              "app",
              "dev"
            ],
            "items": {
              "type": "string"
            }
          },
          "prefixes": {
            "title": "Prefixes",
            "type": "array",
            "description": "For availability mode, optional prefixes added to keywords. Example: [\"get\", \"try\", \"my\"]",
            "items": {
              "type": "string"
            }
          },
          "suffixes": {
            "title": "Suffixes",
            "type": "array",
            "description": "For availability mode, optional suffixes added to keywords. Example: [\"hq\", \"app\", \"shop\"]",
            "items": {
              "type": "string"
            }
          },
          "maxCandidates": {
            "title": "Max candidates",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "For availability mode: upper limit on generated or listed candidates (up to 5,000). Each costs $0.001. Example: 200",
            "default": 200
          },
          "maxDomains": {
            "title": "Max domains",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "For check and monitor: upper limit on domains per run (up to 1,000). Each costs $0.004. Example: 1000",
            "default": 1000
          },
          "concurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Domains checked in parallel. Requests to one host are still paced (RDAP 0.5 s, websites 1 s). Example: 5",
            "default": 5
          },
          "generateReport": {
            "title": "Summary report (report.json + report.html)",
            "type": "boolean",
            "description": "true = one summary per run, report.json + report.html ($0.05). CSV is always included free. Example: true",
            "default": true
          },
          "googleSafeBrowsingKey": {
            "title": "Your Google Safe Browsing / Web Risk API key (optional)",
            "type": "string",
            "description": "Optional: your own Google Safe Browsing key, sent only to Google. You are responsible for its terms: the free Safe Browsing API is for non-commercial use. Example format: AIza..."
          },
          "urlhausAuthKey": {
            "title": "Your abuse.ch Auth-Key (optional)",
            "type": "string",
            "description": "Optional: your own key for the URLhaus host lookup. Follow abuse.ch fair-use terms; commercial use may need their paid API. Example format: your abuse.ch Auth-Key"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}