Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Nuclei scan API

The scan API from Nuclei — 5 operation(s) for scan.

Nuclei scan API is one of 36 APIs that Nuclei publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include scan. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 5 paths, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against 3 base URLs: https://api.projectdiscovery.io, https://api.dev.projectdiscovery.io, http://localhost:8085.

5 operations 5 paths 9 schemas 4 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Base URL
https://api.projectdiscovery.io
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Nuclei scan API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-Key (X-API-Key). By default, every request must be authenticated.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 4 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

scan 5
GET
/v1/scans/vulns/exposures/metrics
Get scan vuln exposure metrics
get-v1-scans-vulns-exposures-metrics 2 params → 200400401404500default
GET
/v1/scans/vulns/regression/metrics
Get scan vuln regression metrics
get-v1-scans-vulns-regression-metrics 2 params → 200400401404500default
GET
/v1/scans/vulns/remediation/metrics
Get scan vuln remediation metrics
get-v1-scans-vulns-remediation-metrics 2 params → 200400401404500default
POST
/v1/scans/validate
Validate scan token before starting scan
post-v1-scans-validate 1 param body → 200400401404500default
GET
/v1/scans/remediation-efficiency
Get remediation efficiency stats
get-v1-scans-remediation-efficiency 1 param → 200400401404500default

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are AssetFilters (22 properties), StatusBreakdown (7 properties), SeverityBreakdown (6 properties), RemediationEfficiencyData (6 properties). Each schema is shown below with its type and property counts.

EnumerationIDTypes
object
1 property 1 required
AssetFilters
object
22 properties
TimeRangeQueryParameter
string
ScanExposuresTimeSeries
object
4 properties 4 required
RemediationEfficiencyData
object
6 properties 6 required
VulnMetricSeverityBreakdown
object
4 properties 3 required
StatusBreakdown
object
7 properties
SeverityBreakdown
object
6 properties
ScanRegressionRemediationTimeSeries
object
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nuclei-scan-api-openapi.yml Raw ↑

Other APIs Nuclei publishes across the network.

Nuclei agents API
Nuclei Asset API
Nuclei assets API
Nuclei automations API
Nuclei billing API
Nuclei chaos API
Nuclei configurations API
Nuclei deprecated API
Nuclei domains API
Nuclei elog API
Nuclei enumeration API