Raw schema
{
"type": "object",
"properties": {
"q": {
"description": "Web-style full-text search (quoted phrases, OR, exclusions), or an exact CVE ID.",
"type": [
"string",
"null"
],
"default": null
},
"severity": {
"description": "Comma list: CRITICAL,HIGH,MEDIUM,LOW.",
"type": [
"string",
"null"
],
"default": null
},
"kev": {
"description": "true: known-exploited only; false: exclude KEV; omitted: either.",
"type": [
"boolean",
"null"
],
"default": null
},
"ransomware": {
"description": "true: CISA ransomware-linked only; false/omitted: no ransomware filter.",
"type": [
"boolean",
"null"
],
"default": null
},
"min_epss": {
"description": "Minimum EPSS probability, 0 to 1 (0.1 means 10%).",
"type": [
"number",
"null"
],
"default": null
},
"min_cvss": {
"description": "Minimum CVSS score, 0 to 10.",
"type": [
"number",
"null"
],
"default": null
},
"vendor": {
"description": "Vendor CPE name, e.g. microsoft; call find_product first.",
"type": [
"string",
"null"
],
"default": null
},
"product": {
"description": "Product CPE name, e.g. windows_server_2022; requires vendor. Call find_product first.",
"type": [
"string",
"null"
],
"default": null
},
"cwe": {
"description": "Weakness ID, e.g. CWE-79 or 79.",
"type": [
"string",
"null"
],
"default": null
},
"since": {
"description": "Inclusive publication lower bound, ISO 8601 date/timestamp; dates use UTC midnight.",
"type": [
"string",
"null"
],
"default": null
},
"until": {
"description": "Inclusive publication upper bound, ISO 8601 date/timestamp; dates use UTC midnight.",
"type": [
"string",
"null"
],
"default": null
},
"sort": {
"description": "Descending order: published (default), modified, cvss, epss or kev.",
"type": [
"string",
"null"
],
"default": null
},
"page": {
"description": "Page number, starting at 1; capped at the API's maximum offset.",
"type": "integer",
"default": 1
},
"page_size": {
"description": "Results per page, default 10; clamped to 1–50.",
"type": "integer",
"default": 10
}
}
}