Shodan icon

Shodan

Interact with Shodan API

Actions8

Search → Query

AI-generated

Summary

Performs a Shodan search query and returns matching host records.

Inputs

  • query (required) — Search query string, e.g. 'apache country:US'
  • additionalFields — Optional collection of extra parameters such as facets, limit, page, and minify
  • requestOptions — Optional network options including proxy, timeout, and batching settings

Output shape

an object containing a matches array of result objects

Results are paginated via the page parameter; additional fields may be omitted; errors follow the standard Shodan API error format

Examples

Example 1: Search for web servers in the United States

{"query":"web server country:US","additionalFields":{"limit":20,"minify":false}}

Example 2: Count matches for a query without retrieving results

{"query":"python language:Python","additionalFields":{"limit":10}}

Example 3: Retrieve additional facets for results

{"query":"apache country:US","additionalFields":{"facets":"org,host"}}

Links

Discussion