vulners 4.4.0

v4.4.0

on Python PyPI

Vulners Python SDK 4.4.0

Added

• documents.list_references(id, *, type=..., limit=20, offset=0, fields=...) — page through
  every bulletin related to id through a shared CVE, via GET /api/v4/search/references.
  Returns a ReferencesPage (async: AsyncReferencesPage, both importable from vulners):
  • iterating the page fetches the following pages until the relation is exhausted;
  • total and total_by_type describe the whole relation as visible to your licence,
    regardless of the type filter and of the page;
  • ids of related documents that no longer exist are listed in missing instead of data.

from vulners import Vulners

with Vulners(api_key="YOUR_API_KEY_HERE") as v:
    page = v.documents.list_references("CVE-2021-44228", type="exploitdb", limit=100)
    print(page.total, page.total_by_type)  # the whole relation
    for bulletin in page:                  # fetches the following pages as needed
        print(bulletin.id)

Documentation

• documents.references() and the references=True lookups are capped by the server at
  1000 related documents per id; when a list is cut, /api/v3/search/id answers
  206 Partial Content with the usual body. Both clients already treat 206 as success; use
  documents.list_references() for the full relation.
• metrics.epss in audit results is a one-element list holding the highest-EPSS CVE as a full
  record {cve, epss, percentile, date}, the same shape on every audit endpoint; per-CVE scores
  are in cvelistMetrics (or the advisory's epss[] on sbom_audit).

Full changelog: https://github.com/vulnersCom/api/blob/master/CHANGELOG.md