# Technology Asset Search

POST /easm/technologies/asset-search: Searches technologies per asset (one record per asset + technology).

Source: https://docs.deepinfo.com/reference/easm/technology-asset-search/

Last updated: 2026-09-27

---
`POST https://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

| Parameter | Required | Description | Example |
|---|---|---|---|
| `page_size` | Optional | Min `25`, max `100`. Default `100`. | `25` |
| `page` | Optional | Min `1`, max `800`. Default `1`. | `1` |

## Request Body

| Parameter | Type | Required | Description |
|---|---|---|---|
| `filters` | object | Optional | See [Filtering](#ref-filtering) below |
| `sort` | object | Optional | One `{field, order}` object |

```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_version` | `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_version` | 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_version` | 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_size` | integer |
| `result_count` | integer |
| `results` | array of object |
| `results[].id` | string |
| `results[].technology` | string |
| `results[].favicon` | string |
| `results[].asset` | object |
| `results[].categories` | array of string |
| `results[].versions` | array of object |
| `results[].latest_version` | string |
| `results[].vulnerability_stats` | object |

Paginated. See [Getting Started → Pagination](/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 |
|---|---|
| `page` | number |
| `page_size` | number |
| `result_count` | number |
| `results` | array<object> |
| `results[].id` | string |
| `results[].technology` | string |
| `results[].favicon` | string |
| `results[].asset` | object |
| `results[].asset.id` | string |
| `results[].asset.name` | string |
| `results[].asset.name_unicode` | string |
| `results[].asset.type` | string |
| `results[].categories` | array<string> |
| `results[].versions` | array<object> |
| `results[].versions[].version` | string |
| `results[].versions[].has_vulnerability` | boolean |
| `results[].latest_version` | string |
| `results[].vulnerability_stats` | object |
| `results[].vulnerability_stats.total` | number |
| `results[].vulnerability_stats.by_severity` | object |
| `results[].vulnerability_stats.by_severity.critical` | number |
| `results[].vulnerability_stats.by_severity.high` | number |
| `results[].vulnerability_stats.by_severity.medium` | number |
| `results[].vulnerability_stats.by_severity.low` | number |
| `results[].vulnerability_stats.by_severity.none` | number |
| `results[].vulnerability_stats.by_severity.unknown` | number |

## Examples

### 200 · OK

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/technologies/asset-search?page_size=25' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "page": 1,
  "page_size": 25,
  "result_count": 21,
  "results": [
    {
      "id": "00000000000000000000000e2cc20001",
      "technology": "Nginx",
      "favicon": "acme.svg",
      "asset": {
        "id": "000000000000000ea4f90001",
        "name": "acme.example",
        "name_unicode": "acme.example",
        "type": "domain"
      },
      "categories": [
        "Web servers"
      ],
      "versions": [
        {
          "version": "1.0.0",
          "has_vulnerability": false
        }
      ],
      "latest_version": "1.0.0",
      "vulnerability_stats": {
        "total": 129,
        "by_severity": {
          "critical": 6,
          "high": 25,
          "medium": 31,
          "low": 14,
          "none": 33,
          "unknown": 20
        }
      }
    },
    {
      "id": "00000000000000000000000e2cc20002",
      "technology": "React",
      "favicon": "acme-2.svg",
      "asset": {
        "id": "000000000000000ea4f90002",
        "name": "fernhill.example",
        "name_unicode": "fernhill.example",
        "type": "domain"
      },
      "categories": [
        "UI frameworks"
      ],
      "versions": [
        {
          "version": "1.0.0",
          "has_vulnerability": false
        }
      ],
      "latest_version": "1.0.0",
      "vulnerability_stats": {
        "total": 135,
        "by_severity": {
          "critical": 7,
          "high": 26,
          "medium": 32,
          "low": 15,
          "none": 34,
          "unknown": 21
        }
      }
    }
  ]
}
```

### 400 · Invalid Parameter (invalid page=0)

```bash
curl -X POST 'https://api.deepinfo.com/v1/easm/technologies/asset-search?page=0' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

`Content-Type: application/json` · `deepinfo-request-id: 00000000-0000-4000-8000-0000356d0001`

```json
{
  "code": 10400,
  "parameters": [
    {
      "param": "page",
      "details": [
        "Ensure this value is greater than or equal to 1."
      ]
    }
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```