Actions8
- CTL (Certificate Transparency) Actions
- DNS Record Actions
- Domain Actions
- Host Actions
- Search Actions
Search → Query
AI-generatedSummary
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
pageparameter; 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"}}