/api/Search

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

The Vulnerability Search API endpoint empowers clients to perform advanced, flexible searches over a large corpus of vulnerability data. It is designed to support a wide variety of use cases, including threat intelligence analysis, vulnerability management workflows, reporting, and automated ingestion into security platforms.

This endpoint provides a robust and highly customizable interface through an extensive set of query parameters. Users can precisely filter and narrow down results based on:

Free-text search in titles, descriptions, and metadata,

Specific vendor and product names to isolate relevant software or hardware vulnerabilities,

Date ranges for when vulnerabilities were identified or last updated,

Severity scoring filters using CVSS (Common Vulnerability Scoring System) and EPSS (Exploit Prediction Scoring System),

Risk ratings to capture organizational severity categories,

Tags for thematic or contextual classification (e.g., ransomware, zero-day, remote code execution),

Options to include advanced metadata, return only IDs, and control pagination of results.

Whether the goal is to locate high-risk vulnerabilities for a particular vendor in a defined timeframe or to extract a structured list of vulnerability IDs for automation purposes, this endpoint enables deep and accurate data access with high performance and clarity.

✅ Common Use Cases
Identify all critical vulnerabilities affecting a given vendor and product in the last 30 days.

Export a list of vulnerability IDs with a CVSS score above 7.5 and EPSS score above 0.5.

Filter vulnerabilities by assigned tags such as supply-chain, rce, or phishing.

Generate weekly or monthly reports based on date filters and severity levels.

Drive automated remediation workflows by pulling targeted vulnerability sets

ParameterTypeRequiredDescription
textstringYesGeneral text search across vulnerability descriptions and metadata.
vendorSearchValuestringYesFilters vulnerabilities by vendor name.
productSearchValuestringYesFilters vulnerabilities by product name.
dateIdentifiedFromstring (ISO 8601 date)YesStart date for the "identified" date range filter.
dateIdentifiedTostring (ISO 8601 date)YesEnd date for the "identified" date range filter.
dateUpdatedFromstring (ISO 8601 date)YesStart date for the "updated" date range filter.
dateUpdatedTostring (ISO 8601 date)YesEnd date for the "updated" date range filter.
tagsstring[]Yes

List of tags to filter vulnerabilities (e.g., `["CisaKev","NotInNvd",

"PotentialPoc",
"MetasploitModule",
"NucleiTemplate",
"PatchTuesday",
"PotentialPublicExploit",
"CytidelSpotlight",
"KnownThreatActor",
"GithubRepo"]`).

cvssScoreFromnumberYesMinimum CVSS score for filtering.
cvssScoreTonumberYesMaximum CVSS score for filtering.
epssScoreFromnumberYesMinimum EPSS score for filtering.
epssScoreTonumberYesMaximum EPSS score for filtering.
lowRiskRatingbooleanYesInclude vulnerabilities with a Low risk rating.
moderateRiskRatingbooleanYesInclude vulnerabilities with a Moderate risk rating.
elevatedRiskRatingbooleanYesInclude vulnerabilities with an Elevated risk rating.
highRiskRatingbooleanYesInclude vulnerabilities with a High risk rating.
significantRiskRatingbooleanYesInclude vulnerabilities with a Significant risk rating.
textFilterstringYesAdditional keyword filter on free-form text fields.
includeAdvancedDatabooleanYesIf true, includes extended metadata in the response.
onlyVulnerabilityIdsbooleanYesIf true, response will return only vulnerability IDs without full details.
pagenumberYesPage number for pagination.
sizenumberYesNumber of results per page.
Query Params
string

Free-text search input that matches across multiple fields.

string

Search term to filter by vendor name.

string

Search term to filter by product name.

date-time

Start date for filtering identified vulnerabilities.

date-time

End date for filtering identified vulnerabilities.

date-time

Start date for filtering updated vulnerabilities.

date-time

End date for filtering updated vulnerabilities.

tags
array of strings

Tags to filter the results.

tags
double

Minimum CVSS score for filtering results.

double

Maximum CVSS score for filtering results.

double

Minimum EPSS score for filtering results.

double

Maximum EPSS score for filtering results.

boolean

Include results with a low risk rating.

boolean

Include results with a moderate risk rating.

boolean

Include results with an elevated risk rating.

boolean

Include results with a high risk rating.

boolean

Include results with a significant risk rating.

string

Filter to apply after consider the relevance.

string

Search mode for vendorSearchValue and productSearchValue fields. Use 'exact' for exact term/phrase matching, or 'fuzzy' for approximate matching that tolerates typos. Example: searchType=exact or searchType=fuzzy

int32

Maximum edit distance for fuzzy search (1-2). Only applies when searchType=fuzzy. Controls how many character changes are allowed. Example: maxEdits=1 for strict fuzzy, maxEdits=2 for more tolerance. Default is 2.

boolean

Determines whether advanced data is included in the result. Defaults to false.

boolean

Determines whether to include only vulnerabilities on the result. Defaults to false.

extraFields
array of objects

Optional additional fields to include in the response. Allowed values: Metadata, Configurations, ProductVersions. Fields are omitted unless requested.

extraFields
Allowed:
int32

The 1-based index of the page to retrieve. Defaults to 1.

int32

The maximum number of items to return per page. Defaults to 10. Maximum allowed is 1000.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Unauthorized

500

Internal Server Error

503

Service Unavailable (Rate Limit)

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json