Technology Search
POST
https://api.deepinfo.com/v1/easm/technologies/searchSearches technologies detected on your assets, with versions and vulnerability counts.
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 |
categories | equals, not_equals, contains, not_contains |
affected_ | gt, gte, lt, lte |
versions | equals, not_equals; each takes a list of values |
version_ | a plain value: all, out_of_date |
latest_ | equals, not_equals |
vulnerability_ | gt, gte, lt, lte |
Searchable Fields
| Field | Description |
|---|---|
technology | The technology's name, such as PHP or nginx; the list's TECHNOLOGY column. Matching is case-insensitive. |
categories | The technology's categories, such as Web servers or JavaScript libraries. A technology can have several. |
affected_ | How many of your assets use the technology. |
versions | The 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_ | out_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_ | The latest released version of the technology, such as 1.2.3; unknown when it is not known. |
vulnerability_ | The 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
| Field | Description |
|---|---|
technology | The technology's name, such as PHP or nginx; the list's TECHNOLOGY column. Matching is case-insensitive. |
categories | The technology's categories, such as Web servers or JavaScript libraries. A technology can have several. |
affected_ | How many of your assets use the technology. |
versions | The 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_ | The latest released version of the technology, such as 1.2.3; unknown when it is not known. |
vulnerability_ | The 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
| Field | Type |
|---|---|
page | integer |
page_ | integer |
result_ | integer |
results | array of object |
results[]. | string |
results[]. | string |
results[]. | string |
results[]. | array of string |
results[]. | integer |
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.png" |
results[]. | array< | "Web servers" |
results[]. | number | 33 |
results[]. | array< | |
results[]. | string | "1.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.