Shodan

Connection Requirements

1 - Domain

The base domain of the Shodan API.

Default: api.shodan.io

2 - API Key

Log in to your Shodan account at account.shodan.io and copy your API key from the dashboard.

3 - Query

A Shodan search query to define which hosts to collect. Supports any valid Shodan query syntax:

• net:203.0.113.0/24 — Scan a CIDR range

• org:"Company Name" — Hosts by organization

• port:22 country:US — Filter by port and country

4 - Proxy

Proxy URL (optional).

5 - Timeout

The amount of time (in seconds) to wait for API responses. (default: 30)

6 - Max Pages

Limits the number of pages fetched from the Shodan search API. Each page returns 100 results and costs 1 query credit. A broad query (e.g. port:80) can match millions of hosts, consuming all your credits and significant memory. Set this to cap both credit spend and resource usage. (default: 0 — no limit)

Attention

Please perform a connection test to ensure there is a valid connection to the Shodan API host. When the discovery operation is finalized you will be able to see the details on Assets page.