Shodan icon

Shodan

Interact with Shodan API

Actions6

Overview

This node interacts with the Shodan API to perform a search count operation. It allows users to input a Shodan search query and retrieve the total number of results matching that query without consuming API credits. This is useful for quickly estimating the volume of data available for a specific search term or filter, such as counting hosts running a particular service or located in a specific country.

Use Case Examples

  1. Count the number of hosts running Apache servers in the US using the query 'apache country:US'.
  2. Get a summary count of devices by organization or country using facets in the search query.

Properties

Name Meaning
Query The Shodan search query string used to filter the search results.
Additional Fields Optional parameters to refine the search count, including facets for summary information, limit, page, and minify options.
Request Options Settings for request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • total - Total number of results matching the search query.
  • facets - Summary information on specified properties if facets are requested.

Dependencies

  • Requires an API key credential for Shodan API authentication.

Troubleshooting

  • Ensure the Shodan API key credential is correctly configured and has sufficient permissions.
  • Verify the search query syntax is valid according to Shodan's query language to avoid errors.
  • If using facets, ensure the facet properties are valid and supported by Shodan.
  • Check network settings if using a proxy or if SSL issues occur; enable 'Ignore SSL Issues' only if necessary.

Links

Discussion