Technology Asset Search
POST
https://api.deepinfo.com/v1/easm/technologies/asset-searchSearches technologies per asset (one record per asset + technology).
Authentication
Send your API key in the apikey request header.
Query Parameters
| Parameter | Required | Description |
|---|---|---|
page_ | Optional | Min 25, max 100. Default 100.Example 25 |
page | Optional | Min 1, max 800. Default 1.Example 1 |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
filters | object | Optional | See Filtering below |
sort | object | Optional | 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:
| Field | Operators |
|---|---|
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_ | equals, not_equals |
vulnerabilities | gt, gte, lt, lte |
Searchable Fields
| Field | Description |
|---|---|
technology | The technology's name, such as PHP. Matching is case-insensitive. |
asset | The name of the asset the technology was found on, such as www.acme.example. |
categories | The technology's categories, such as Web servers. |
versions | The versions of the technology found on this asset, such as 1.0.0; unknown when no version was detected. |
latest_ | The latest released version of the technology, such as 1.2.3; unknown when it is not known. |
vulnerabilities | The number of known vulnerabilities of the technology's versions on this asset (vulnerability_stats.total in the response). |
Sortable Fields
| Field | Description |
|---|---|
technology | The technology's name, such as PHP. Matching is case-insensitive. |
asset | The name of the asset the technology was found on, such as www.acme.example. |
categories | The technology's categories, such as Web servers. |
versions | The versions of the technology found on this asset, such as 1.0.0; unknown when no version was detected. |
latest_ | The latest released version of the technology, such as 1.2.3; unknown when it is not known. |
vulnerabilities | The number of known vulnerabilities of the technology's versions on this asset (vulnerability_stats.total in the response). |
Response Fields
| Field | Type |
|---|---|
page | integer |
page_ | integer |
result_ | integer |
results | array of object |
results[]. | string |
results[]. | string |
results[]. | string |
results[]. | object |
results[]. | array of string |
results[]. | array of object |
results[]. | string |
results[]. | object |
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.
| Field | Type | Example |
|---|---|---|
page | number | 1 |
page_size | number | 25 |
result_count | number | 21 |
results | array< | |
results[]. | string | "00000000000000000000000e2cc20001" |
results[]. | string | "Nginx" |
results[]. | string | "acme.svg" |
results[]. | object | |
results[]. | string | "000000000000000ea4f90001" |
results[]. | string | "acme.example" |
results[]. | string | "acme.example" |
results[]. | string | "domain" |
results[]. | array< | "Web servers" |
results[]. | array< | |
results[]. | string | "1.0.0" |
results[]. | boolean | false |
results[]. | string | "1.0.0" |
results[]. | object | |
results[]. | number | 129 |
results[]. | object | |
results[]. | number | 6 |
results[]. | number | 25 |
results[]. | number | 31 |
results[]. | number | 14 |
results[]. | number | 33 |
results[]. | number | 20 |
Examples
Selecting one loads it into the request and response panels.