# NIST National Vulnerability Database (NVD) · Search

Get developer and code data with NIST National Vulnerability Database (NVD) · Search from Alexandria through one Spiral API key. Find CVEs affecting a product or version (cpe_match cpe:2.3:a:apache:log4j:2.14.1), with a weakness (CWE-79), that are actively exploited (in_kev), or matching words. Use `cve` for a known id and its full CPE list and references. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Developer
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `nvd-nist-gov/vulnerabilities/search`
- Page: https://spiral.ai/tools/alexandria/nvd-nist-gov/vulnerabilities/search

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `cursor` | text |  | — | next_cursor from the previous page. Pattern: ^[0-9]{1,8}$. |
| `cwe_id` | text |  | — | CWE id, e.g. CWE-79, CWE-917, NVD-CWE-noinfo. Pattern: ^\s*([Cc][Ww][Ee]-[0-9]{1,6}\|[Nn][Vv][Dd]-[Cc][Ww][Ee]-([Oo][Tt][Hh][Ee][Rr]\|[Nn][Oo][Ii][Nn][Ff][Oo]))\s*$. |
| `in_kev` | true or false |  | — | Only CVEs in CISA's Known Exploited Vulnerabilities catalog. |
| `api_key` | text |  | — | Optional NVD API key (raises NVD's limit from 5 to 50 requests per 30 seconds). Sent only in the apiKey header; never placed in URLs or output. Pattern: ^[A-Za-z0-9-]{16,64}$. |
| `keyword` | text |  | — | Words that must all appear in the CVE description (NVD keywordSearch). |
| `cpe_name` | text |  | — | One full CPE 2.3 name from NVD's CPE dictionary, e.g. cpe:2.3:o:microsoft:windows_10:1607:*:*:*:*:*:*:*. Mutually exclusive with cpe_match. |
| `cpe_match` | text |  | — | CPE 2.3 prefix matched against applicability statements, including version ranges: cpe:2.3:a:apache:log4j (all versions) or cpe:2.3:a:apache:log4j:2.14.1 (that version). |
| `page_size` | number | 1 to 50 | 10 | Records per page. |
| `modified_to` | text |  | — | Last last-modified day, YYYY-MM-DD (UTC), inclusive. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `published_to` | text |  | — | Last publication day, YYYY-MM-DD (UTC), inclusive. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `is_vulnerable` | true or false |  | — | With cpe_name, only CVEs where that CPE is itself vulnerable (not just a platform). |
| `modified_from` | text |  | — | First last-modified day, YYYY-MM-DD (UTC). Needs modified_to; at most 120 days. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `published_from` | text |  | — | First publication day, YYYY-MM-DD (UTC). Needs published_to; at most 120 days. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
| `cvss_v3_severity` | one of | LOW, MEDIUM, HIGH, CRITICAL, low, medium, high, critical | — | Only CVEs with this CVSS v3 base severity. |
| `cvss_v4_severity` | one of | LOW, MEDIUM, HIGH, CRITICAL, low, medium, high, critical | — | Only CVEs with this CVSS v4 base severity. |
| `include_rejected` | true or false |  | — | Include CVEs NVD lists as Rejected. |
| `keyword_exact_match` | true or false |  | — | Match keyword as an exact phrase. Needs keyword. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "nvd-nist-gov/vulnerabilities/search",
    "input": {
      "cursor": "<cursor>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=nvd-nist-gov%2Fvulnerabilities%2Fsearch

## Common questions

### NIST National Vulnerability Database (NVD) · Search

**How much does NIST National Vulnerability Database (NVD) · Search cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use NIST National Vulnerability Database (NVD) · Search through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "nvd-nist-gov/vulnerabilities/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use NIST National Vulnerability Database (NVD) · Search?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use NIST National Vulnerability Database (NVD) · Search?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

