POSThttps://api.deepinfo.com/v1/easm/technologies/search

Searches technologies detected on your assets, with versions and vulnerability counts.

Authentication

Send your API key in the apikey request header.

Query Parameters

ParameterRequiredDescription
page_sizeOptional
Min 25, max 100. Default 100.
Example25
pageOptional
Min 1, max 800. Default 1.
Example1

Request Body

ParameterTypeRequiredDescription
filtersobjectOptional
See Filtering below
sortobjectOptional
One {field, order} object
application/json
{}

Filtering

This search takes filters as an object with one key per field, not as a must list. Each field takes the operators of its filter type as keys, and fields combine with AND. sort is one {field, order} object, not a list. Example body:

JSON
{
  "filters": {
    "technology": {
      "equals": "<value>"
    }
  },
  "sort": {
    "field": "technology",
    "order": "desc"
  }
}

Operators by field:

FieldOperators
technology
equals, not_equals, contains, not_contains
categories
equals, not_equals, contains, not_contains
affected_asset_count
gt, gte, lt, lte
versions
equals, not_equals; each takes a list of values
version_scope
a plain value: all, out_of_date
latest_version
equals, not_equals
vulnerability_stats
gt, gte, lt, lte

Searchable Fields

FieldDescription
technologyThe technology's name, such as PHP or nginx; the list's TECHNOLOGY column. Matching is case-insensitive.
categoriesThe technology's categories, such as Web servers or JavaScript libraries. A technology can have several.
affected_asset_countHow many of your assets use the technology.
versionsThe versions of the technology found on your assets, such as 1.0.0; unknown when no version was detected. Each version says whether it has known vulnerabilities.
version_scopeout_of_date keeps only technologies with a version older than the latest one; all (the default) keeps every technology. The platform's VERSION SCOPE filter.
latest_versionThe latest released version of the technology, such as 1.2.3; unknown when it is not known.
vulnerability_statsThe number of known vulnerabilities of the technology's versions on your assets (vulnerability_stats.total in the response); the platform's TOTAL VULN. COUNT.

Sortable Fields

FieldDescription
technologyThe technology's name, such as PHP or nginx; the list's TECHNOLOGY column. Matching is case-insensitive.
categoriesThe technology's categories, such as Web servers or JavaScript libraries. A technology can have several.
affected_asset_countHow many of your assets use the technology.
versionsThe versions of the technology found on your assets, such as 1.0.0; unknown when no version was detected. Each version says whether it has known vulnerabilities.
latest_versionThe latest released version of the technology, such as 1.2.3; unknown when it is not known.
vulnerability_statsThe number of known vulnerabilities of the technology's versions on your assets (vulnerability_stats.total in the response); the platform's TOTAL VULN. COUNT.

Response Fields

FieldType
pageinteger
page_sizeinteger
result_countinteger
resultsarray of object
results[].idstring
results[].technologystring
results[].faviconstring
results[].categoriesarray of string
results[].affected_asset_countinteger
results[].versionsarray of object
results[].latest_versionstring
results[].vulnerability_statsobject

Paginated. See Getting Started → Pagination.

Response Schema

Inferred from examples Built from the saved 2xx example response: the fields it contains, with the types seen there. It is not a contract.

FieldTypeExample
pagenumber1
page_sizenumber25
result_countnumber21
resultsarray<object>
results[].idstring"00000000000000000000000e2cc20001"
results[].technologystring"Nginx"
results[].faviconstring"acme.png"
results[].categoriesarray<string>"Web servers"
results[].affected_asset_countnumber33
results[].versionsarray<object>
results[].versions[].versionstring"1.0"
results[].versions[].has_vulnerabilitybooleanfalse
results[].latest_versionstring"1.0.0"
results[].vulnerability_statsobject
results[].vulnerability_stats.totalnumber129
results[].vulnerability_stats.by_severityobject
results[].vulnerability_stats.by_severity.criticalnumber6
results[].vulnerability_stats.by_severity.highnumber25
results[].vulnerability_stats.by_severity.mediumnumber31
results[].vulnerability_stats.by_severity.lownumber14
results[].vulnerability_stats.by_severity.nonenumber33
results[].vulnerability_stats.by_severity.unknownnumber20

Examples

Selecting one loads it into the request and response panels.

Reference updated