Reference Data

Look up top ports, a CVE, and recently seen hosts and domains.

Top ports

These routes return the most common ports, which you can paste into a scan's ports array or compare with a top_N token.

GET/v3/info/ports/tcp/{count}

Top TCP ports

GET/v3/info/ports/udp/{count}

Top UDP ports

curl -sS "https://api.efflux.io/v3/info/ports/tcp/100" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

{count} is how many ports to return. A scan can also say "ports": ["top_1000"] and skip this call. See Scans.

CVE lookup

GET/v3/info/cves/{cve_id}

One CVE

curl -sS "https://api.efflux.io/v3/info/cves/CVE-2021-44228" \
  -H "Authorization: Bearer $EFFLUX_TOKEN"

To test a host for CVEs you already know, pass them on the scan as cves. That mode cannot be combined with urls or paths.

Recently seen names

GET/v3/info/recent/hosts

Recently seen hosts

GET/v3/info/recent/domains

Recently seen domains

Usage over time is covered in Limits and Usage.