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

Searches technologies per asset (one record per asset + technology).

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, startswith, endswith; each takes a list of values
asset
equals, not_equals, contains, not_contains, startswith, endswith; each takes a list of values
categories
equals, not_equals, contains, not_contains
versions
equals, not_equals; each takes a list of values
latest_version
equals, not_equals
vulnerabilities
gt, gte, lt, lte

Searchable Fields

FieldDescription
technologyThe technology's name, such as PHP. Matching is case-insensitive.
assetThe name of the asset the technology was found on, such as www.acme.example.
categoriesThe technology's categories, such as Web servers.
versionsThe versions of the technology found on this asset, such as 1.0.0; unknown when no version was detected.
latest_versionThe latest released version of the technology, such as 1.2.3; unknown when it is not known.
vulnerabilitiesThe number of known vulnerabilities of the technology's versions on this asset (vulnerability_stats.total in the response).

Sortable Fields

FieldDescription
technologyThe technology's name, such as PHP. Matching is case-insensitive.
assetThe name of the asset the technology was found on, such as www.acme.example.
categoriesThe technology's categories, such as Web servers.
versionsThe versions of the technology found on this asset, such as 1.0.0; unknown when no version was detected.
latest_versionThe latest released version of the technology, such as 1.2.3; unknown when it is not known.
vulnerabilitiesThe number of known vulnerabilities of the technology's versions on this asset (vulnerability_stats.total in the response).

Response Fields

FieldType
pageinteger
page_sizeinteger
result_countinteger
resultsarray of object
results[].idstring
results[].technologystring
results[].faviconstring
results[].assetobject
results[].categoriesarray of string
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.svg"
results[].assetobject
results[].asset.idstring"000000000000000ea4f90001"
results[].asset.namestring"acme.example"
results[].asset.name_unicodestring"acme.example"
results[].asset.typestring"domain"
results[].categoriesarray<string>"Web servers"
results[].versionsarray<object>
results[].versions[].versionstring"1.0.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