# Search

POST /discovery/darkweb-search: Searches dark web content by free text, by indicators and by sources. At least one of them is required.

Source: https://docs.deepinfo.com/reference/darkweb/search/

Last updated: 2026-09-27

---
`POST https://api.deepinfo.com/v1/discovery/darkweb-search`

Searches dark web content by free `text`, by indicators and by sources. At least one of them is required.

Indicators:

- `email`
- `email_apex`
- `ip_address`
- `crypto_address`
- `ccn`
- `cve`
- `ssn`
- `website_mention`
- `data_leak`

Sources:

- `source_type`
- `source_group`
- `source_domain`

Narrow the results with:

- `language`
- `crawl_date`
- `post_date`
- `hackishness` (0–1)

Sort with `sorting`.

## Authentication

Send your API key in the `apikey` request header.

## Query Parameters

| Parameter | Required | Description | Example |
|---|---|---|---|
| `page` | Optional | Min `1`, max `250`. Default `1`. | `1` |

## Request Body

| Parameter | Type | Required |
|---|---|---|
| `text` | string | Optional |
| `include_similar` | boolean | Optional |
| `language` | array | Optional |
| `source_domain` | array | Optional |
| `crawl_date` | object | Optional |
| `post_date` | object | Optional |
| `hackishness` | object | Optional |
| `contains` | array | Optional |
| `include_text_content` | boolean | Optional |
| `ccn` | array | Optional |
| `cve` | array | Optional |
| `website_mention` | array | Optional |
| `ssn` | array | Optional |
| `email` | array | Optional |
| `email_apex` | array | Optional |
| `ip_address` | array | Optional |
| `site_id` | string | Optional |
| `crypto_address` | array | Optional |
| `data_leak` | array | Optional |
| `source_type` | array | Optional |
| `source_group` | array | Optional |
| `source_discord_channel` | array | Optional |
| `source_telegram_channel` | array | Optional |
| `sorting` | object | Optional |

```json
{}
```

## Response Fields

| Field | Type |
|---|---|
| `page` | integer |
| `page_size` | integer |
| `result_count` | integer |
| `results` | array of object |
| `results[].id` | string |
| `results[].ref` | string |
| `results[].body` | string |
| `results[].hackishness` | number |
| `results[].title` | string |
| `results[].uri` | string |
| `results[].url` | string |
| `results[].location` | string |
| `results[].crawl_date` | string |
| `results[].file_size` | integer |
| `results[].network` | string |
| `results[].languages` | array of string |
| `results[].domain` | string |
| `results[].site_id` | string |
| `results[].snippet` | string |
| `results[].emails` | array of string |
| `results[].ssns` | array of string |
| `results[].ccns` | array of string |
| `results[].cves` | array of string |
| `results[].websites` | array of string |
| `results[].ips` | array of string |
| `results[].cryptos` | array of string |
| `results[].headers` | array of string |
| `results[].groups` | array of string |
| `results[].paste` | object |
| `results[].market` | object |
| `results[].leak` | object |
| `results[].chat` | object |
| `results[].irc` | object |
| `results[].forum` | object |

Paginated. See [Getting Started → Pagination](/getting-started/pagination/).

> No live example: the DEMO account has no data for this endpoint yet, or it returned an error during testing. The response shape is described above.

## Examples

### 400 · Validation Error (empty body {})

```bash
curl -X POST 'https://api.deepinfo.com/v1/discovery/darkweb-search' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": 410005,
  "details": [
    "One of ['text', 'email', 'email_apex', 'website_mention', 'ip_address', 'crypto_address', 'ccn', 'cve', 'ssn', 'source_type', 'source_group', 'source_domain', 'data_leak'] has to be provided."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

### 400 · Malformed JSON

```bash
curl -X POST 'https://api.deepinfo.com/v1/discovery/darkweb-search' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"filters": '
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": 10400,
  "details": [
    "Invalid JSON data."
  ],
  "solution": "https://docs.deepinfo.com/reference/"
}
```

### 500 · Unexpected Error

```bash
curl -X POST 'https://api.deepinfo.com/v1/discovery/darkweb-search?page=1' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email_apex": [
    "deepinfo.com"
  ]
}'
```

`Content-Type: application/json` · `deepinfo-request-id: 5f0c6a8e-1b2d-4c3e-9f4a-7b8c9d0e1f2a`

```json
{
  "code": -1,
  "details": [
    "An unexpected error has occurred."
  ]
}
```