Updates¶
Get updates on the GitHub repo.
Release History¶
0.9.0 (2026-09-27)¶
Breaking
Removed the
verboseparameter fromsearchCVEandsearchCVE_V2. It has done nothing since 0.7.8. Use the Python logging module instead, see https://nvdlib.com/en/latest/v2/startedv2.html#logging
Bugfixes
Capped the
searchCPEmatchlimit at 500, the Match Criteria API maximum.Fixed CPE match generator requests being sent to the CPE URL.
Stopped requesting an extra empty page when the total results are an exact multiple of the page size.
Fixed the
pubStartDateerror message showingpubEndDate.Corrected CVE, CPE, and match string docstrings to match the live API field names, such as
cisaExploitAddandlastModified.
Enhancements
Added
asDictto every search function to return the plain dictionaries from the NVD API instead of objects.Added
searchCVEHistoryandsearchCVEHistory_V2for the CVE Change History API.Added
searchSourceandsearchSource_V2for the Source API.Added
cveIds,cveTag,kevStartDate, andkevEndDatetosearchCVEandsearchCVE_V2.Added
searchCPEmatch_V2and theproxiesparameter tosearchCPEmatch.CVSS 3.1, 3.0, and 2.0 scores now use the Primary metric when one is present, the same as CVSS 4.0.
cpenow includes the CPE matches from every configuration node, not just the first.Added
ssvcto CVE objects when the CVE includes SSVC data.HTTP errors now include the reason NVD returns in the
messageheader.
0.8.5 (2026-09-27)¶
Enhancements
CVSS 4.0 scores now use the Primary metric when one is present, instead of whichever 4.0 entry is listed first.
scorestill prefers 4.0 over 3.1 when any 4.0 block exists. https://github.com/vehemont/nvdlib/issues/52CVSS 4.0 fields that are present on a CVE are copied onto the CVE object, including
NOT_DEFINED. Missing fields are left unset. Version 4.0 has no exploitability or impact score.Added
cvssV4MetricsandcvssV4SeveritytosearchCVEandsearchCVE_V2.
0.8.4 (2026-09-27)¶
Bugfixes
Fixed
keywordExactMatchonsearchCPEandsearchCPE_V2being sent asTrue. The NVD CPE API expects the flag with no value and was returning 404. https://github.com/vehemont/nvdlib/issues/68Raised the CPE
limitmaximum from 2000 to 10000, matching the CPE API. A full first page larger than 2000 was also being discarded, so a search such assearchCPE(keywordSearch="Jetbrains")came back empty. https://github.com/vehemont/nvdlib/issues/69Fixed
tests/test_search.pyso the fixture paths resolve from the test file. Pytest failed when it was not started from the repository root. https://github.com/vehemont/nvdlib/issues/71
Enhancements
Replaced
setup.pywithpyproject.toml. https://github.com/vehemont/nvdlib/pull/70
0.8.3 (2025-08-06)¶
Bugfixes
Fixed
searchCPEmatchbatching and paging. https://github.com/vehemont/nvdlib/issues/62Updated paging to follow the NVD API page size returned by each response.
0.8.2 (2025-08-06)¶
Bugfixes
Fixed a
JSONDecodeErrorduring paged searches that could leavegetDataunset and raiseUnboundLocalError. https://github.com/vehemont/nvdlib/issues/60Fixed
searchCVE_V2raisingTypeErrorwhen a failed request yielded a response object instead of a dictionary. https://github.com/vehemont/nvdlib/issues/61
Enhancements
Added proxy support to the generator requests in
__get_with_generator.
0.8.1 (2025-05-28)¶
Bugfixes
Fixed the generator failing when
delaywas explicitly passed asNone.Fixed incorrect docstrings, including
CVE.metricsbeing described as a dictionary. https://github.com/vehemont/nvdlib/issues/56
Enhancements
Added
__getattr__so linters handle dynamic CVE and CPE attributes more cleanly.Added a proxy option for API calls. Courtesy of @tigre-bleu in https://github.com/vehemont/nvdlib/pull/55
0.8.0 (2025-03-19)¶
Bugfixes
Fixed passing the boolean to the URL on hasKev, hasOval, hasCertAlerts, hasCertNotes, and keyworkExactMatch in https://github.com/vehemont/nvdlib/issues/54
0.7.9 (2025-01-13)¶
Enhancements
Added missing CVSS 3.0 data for
attackVector,attackComplexity,privilegesRequired,userInteraction,scope,confidentialityImpact,integrityImpact, andavailabilityImpactas reported from https://github.com/vehemont/nvdlib/issues/48Added basic CVSS 4.0 data:
v40score,v40vector, andv40severityin CVEs.Merged https://github.com/vehemont/nvdlib/pull/49 and https://github.com/vehemont/nvdlib/pull/50 to add more type hints and also fixes the MatchString search. Courtesy of @LachJones.
Increased minimum required Python version to
3.11or later from Python 3.8.3. This opens up some cooler features and fixed a compatibility issue withLiteralStringnot being available until 3.11.
0.7.8 (2024-07-11)¶
Enhancements
Merged https://github.com/vehemont/nvdlib/pull/44
Updated delay parameter to a float.
Removed verbose in favor of the Python logging module.
To try out the new logging addition, try the simple logger configuration below. It will create a file named “example_NVDLib.log” and will log NVDLib and Requests actions into the file. Syntax errors/HTTP server errors are logging level of “error”, URLs requested (similar output to the previous verbose parameter) are set to “debug”.
import logging
import nvdlib
logging.basicConfig(filename='example_NVDLib.log', encoding='utf-8', level=logging.DEBUG)
r = nvdlib.searchCVE(keywordSearch="Microsoft")
0.7.7 (2024-06-02)¶
Bugfixes
Fix cwe attr in CVE by @jobselko in https://github.com/vehemont/nvdlib/pull/39
Enhancements
Added CPE Match String API with
nvdlib.searchCPEmatch, check out the documentation at https://nvdlib.com/en/latest/v2/CPEv2.html#cpe-match-criteria-api and more information can be found at the NVD API documentation page: https://nvd.nist.gov/developers/products
Thanks to @jobselko for submitting a PR to resolve the cwe bug.
0.7.6 (2023-11-09)¶
Bugfixes
Merged #35. Fixed a CPE search not pulling all CPE matches.
Enhancements
Merged #34. Added additional vars for CVEs for easy accessability.
Still working on #32 for supporting type hints, but some have been added.
Thanks to @akuster for submitting a PR for these changes.
0.7.5 (2023-10-03)¶
Bugfixes
Merged #30. Added a check if the generator hits 403 rate limit error, instead of breaking the entire generator. Delays twice as long to ensure another 403 isn’t hit.
0.7.4 (2023-05-08)¶
Enhancements
Merged #24. Added the new functions for
searchCVE_V2andsearchCPE_V2. They have the same arguments as their respective counterparts (searchCVEandsearchCPE), but are defined as a generator instead. Yields after each CVE conversion from the response. This is useful for systems with resource constraints.
@nthunk single handedly pushed these features. Thank you.
0.7.3 (2023-03-29)¶
Bugfixes
Merged #22. When using a datetime object in parameters like
pubEndDate, NVDLib will now replace the+character used to denote the time zone with%2Bin the string of parameters, preventing a 404 error and per the NVD API documentation. Normally this is done automatically within requests, but NVDLib passes the parameters as a string rather than a dictionary natively within requests.
Enhancements
Merged #23. Set the optional parameters in
searchCVEandsearchCPEtoNoneinstead ofFalse. Helps out with linters and type assignment mismatches.
Big thanks to @ntnunk for submitting the PRs for these changes.
0.7.2 (2023-03-14)¶
Bugfixes
Fixed parsing of CPEs names to allow special characters with CPE names to function correctly.
Fixed PyTest data, tests are passing now.
Enhancements
Added newer parameters to
nvdlib.searchCVE().noRejected - Filter out CVEs that have a status of rejected.
versionEnd / versionEndType / versionStart / versionStartType - Used with virtualMatchString to provide filters based on versions within CPE names
0.7.1 (2022-12-19)¶
Bugfixes
Fixed the location of
baseSeverity. ThebaseSeverityattribute had its location changed and caused lookups with a CVSS version 2 score to fail.
0.7.0 (2022-10-31)¶
Overhauled NVDLib to utilize the new version of the NVD API (version 2).
nvdlib.getCVE()no longer exists and is now combined intonvdlib.searchCVE()using thecvdIdparameter.nvdlib.searchCPE()no longer has thecvesparameter to pass CVEs.New parameters for
nvdlib.searchCVE()For a full list of changes, see https://nvdlib.com/en/latest/v1/changesv1.html
Happy Halloween! 🎃
0.6.1 (2022-10-18)¶
Bugfixes
Updated
cve.pyto utilize the correct parameter to allow sorting by exact match. The parameter isisExactMatchwith a value ofTrue. The argument used insearchCVEis stillexactMatchwith a value ofTrue, NVDLib will now use the correct parameter when building the search query.
0.6.0 (2022-09-15)¶
Bugfixes
Updated
cve.pyto utilize the correct parameter to allow sorting of CVE collections by date. The parameter issortBywith a value ofpublishDate. By @Smjert in https://github.com/vehemont/nvdlib/pull/8
0.5.9 (2022-09-03)¶
Bugfixes
Update
get.pyandcve.pyto set the request encoding toutf-8to prevent any incorrect decoding of requests.
Improvements
Update
cve.pyto add a request timeout of 30 seconds.Updated
get.pyto enhance theverbose=Trueparameter to work withsearchCVEandsearchCPEand it will now print the parameters with each query to see what page a request is failing on, as utilizing.raise_for_status()to raise an HTTPError object if an error occurs during the request (such as 403 forbidden from too many requests).
0.5.8 (2022-07-19)¶
Bugfixes
Update get.py and cve.py by @GamehunterKaan in https://github.com/vehemont/nvdlib/pull/5
Removed exit() function that causes the program to abort. Modules shouldn’t exit.
Updated cve.py
searchCVEdoc string to include thecweIdparameter.
Improvements
Updated cve.py to include the
sortPublishedparameter that is supposed to sort a CVE collection by published date, rather than the default modified date. In my testing, I have not been able to get this parameter working as expected, and I receive no changes in response with or without thesortOrder=publishedDateparameter.
I have decided to include the parameter since it is a valid API parameter. The NVD developer guide (https://nvd.nist.gov/developers/vulnerabilities) recommends to use this parameter to prevent missing CVEs when searching for large amounts of CVEs.
0.5.7 (2022-05-18)¶
Bugfixes
Update get.py by @GamehunterKaan in https://github.com/vehemont/nvdlib/pull/4
Update request timeout in
get.pyto 30 seconds from 10 seconds because most api requests take longer than 10 seconds.Update exception message from paramaters to str(paramaters) to prevent TypeErrors.
0.5.6 (2022-02-15)¶
Improvements
Added the ability to pass
datetimeobjects to searchCVE and searchCPE as mod/pub dates instead of strings. Strings will still work at this time.
>>> end = datetime.datetime.now()
>>> start = end - datetime.timedelta(days=7)
>>> r = nvdlib.searchCVE(pubStartDate=start, pubEndDate=end, verbose=True)
Filter:
https://services.nvd.nist.gov/rest/json/cves/1.0?pubStartDate=2022-02-08T08:57:26:000 UTC-00:00&pubEndDate=2022-02-15T08:57:26:000 UTC-00:00
>>> len(r)
629
Reworked __buildCVECall to utilize a dictionary to pass to __get using requests params argument, instead of building the string from scratch.
Added a test framework (courtesy of @calve)
Bugfixes
Immediately returned results if the total results from a search equals 20, instead of attempting to request a non-existant page.
0.5.5 (2022-02-10)¶
Improvements
Updated CVE attribute score to include the severity, also rearranged the list to have the CVSS score version as the first element. This attribute is available on all CVEs and is a simpler way to obtain a score for a CVE without minding the version of the score.
Old:
>>> print(r[0].score)
[8.8,'V3']
New:
>>> print(r[0].score)
['V3', 8.8, 'HIGH']
0.5.4 (2022-01-24)¶
Bugfixes
Set score on CVEs with no score (due to awaiting analysis) to
None. This allows for iterating on the score attribute without causing an attribute error.
>>> import nvdlib
>>> r = nvdlib.searchCVE(keyword='log4j', key='xxxxxx-xxxx-xxxx-xxxxx-xxxxxxxx', limit=5)
>>> print([(x.id + ' ' + str(x.score[0])) for x in r])
['CVE-2022-23307 9.8', 'CVE-2021-44228 10.0', 'CVE-2022-21704 None', 'CVE-2021-4104 7.5', 'CVE-2022-23302 None']
0.5.3 (2022-01-20)¶
Improvements
Added rate limiting to requests to accomadate the NIST NVD recommendations.
Read more about it here: https://nvd.nist.gov/developers
You can get an API key for free here: https://nvd.nist.gov/developers/request-an-api-key
tl;dr - No API key = 10 requests per minute, or 6 seconds per request. API key = 100 requests per minute, or 0.6 seconds per request.A key parameter now exists in searchCVE, getCVe, and searchCPE to allow you to include your API key.
>>> r = getCVE('CVE-2021-30640', key='xxxx-xxxxxx-xxxxxxxx')
Remade the parameter building functions to move away from kwargs** and use keyword parameters instead. This removes the requirement for
cpe_dict=Falsewhen making a search or get.