{
  "openapi": "3.0.1",
  "info": {
    "title": "CVE Monitor — New Vulnerability Feed with Alerts",
    "description": "Monitor the NIST National Vulnerability Database (NVD) \nfor new and updated CVEs. Filter by vendor, product, \nCVSS score, or severity level. Get instant Telegram \nalerts when critical vulnerabilities affect your stack.",
    "version": "1.0",
    "x-build-id": "phOqenMfJ3YS0QAo5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/mukedlii~nvd-cve-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-mukedlii-nvd-cve-monitor",
        "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/mukedlii~nvd-cve-monitor/runs": {
      "post": {
        "operationId": "runs-sync-mukedlii-nvd-cve-monitor",
        "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/mukedlii~nvd-cve-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-mukedlii-nvd-cve-monitor",
        "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": {
          "keywords": {
            "title": "Keyword filter (vendor / product)",
            "type": "array",
            "description": "Only return CVEs whose description contains at least one of these keywords (e.g. vendor or product names). Leave empty for all CVEs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "min_cvss_score": {
            "title": "Minimum CVSS score",
            "minimum": 0,
            "maximum": 10,
            "type": "number",
            "description": "Only return CVEs with CVSS v3 base score >= this value. 0 = all severities.",
            "default": 0
          },
          "severities": {
            "title": "Severity filter",
            "type": "array",
            "description": "Only return CVEs matching these severity levels. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "CRITICAL",
                "HIGH",
                "MEDIUM",
                "LOW"
              ],
              "enumTitles": [
                "CRITICAL (CVSS 9.0–10.0)",
                "HIGH (CVSS 7.0–8.9)",
                "MEDIUM (CVSS 4.0–6.9)",
                "LOW (CVSS 0.1–3.9)"
              ]
            },
            "default": []
          },
          "include_modified": {
            "title": "Include modified CVEs",
            "type": "boolean",
            "description": "Also return CVEs that were updated/modified (not just newly published) since last run.",
            "default": false
          },
          "delta_mode": {
            "title": "Delta mode (only new CVEs)",
            "type": "boolean",
            "description": "Only return CVEs not seen in previous runs. Uses Apify KV Store for deduplication.",
            "default": true
          },
          "days_back": {
            "title": "Days back (initial / full run)",
            "minimum": 1,
            "maximum": 120,
            "type": "integer",
            "description": "Fetch CVEs published/modified in the last N days. On delta runs, only new ones are returned.",
            "default": 1
          },
          "max_cves": {
            "title": "Max CVEs to fetch",
            "minimum": 0,
            "maximum": 2000,
            "type": "integer",
            "description": "Maximum CVEs to return per run. 0 = unlimited (NVD max 2000/request).",
            "default": 200
          },
          "nvd_api_key": {
            "title": "NVD API key (optional)",
            "type": "string",
            "description": "Free NVD API key from nvd.nist.gov/developers/request-an-api-key. Without key: 5 req/30s limit. With key: 50 req/30s. Use Apify Secret (e.g. @NVD_API_KEY)."
          },
          "telegram_bot_token": {
            "title": "Telegram bot token",
            "type": "string",
            "description": "Your Telegram bot token from @BotFather. Use Apify Secret (e.g. @TELEGRAM_TOKEN)."
          },
          "telegram_chat_id": {
            "title": "Telegram chat ID",
            "type": "string",
            "description": "Your Telegram chat or group ID. Get it from @userinfobot."
          },
          "webhook_url": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "POST results to this URL (Zapier, Make, n8n, Slack, etc.)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}