Shodan

searchDevice

1 credit per call

Search for internet-connected devices using Shodan's database

Try it

Open in playground
kirha tools run shodan_searchDevice \
  --input '{
    "query": "country:US"
  }'

Uses the key saved by kirha auth login.

  • querystring, required

    Shodan search query. Format: 'keywords filter:value'. Common filters: country:CODE (e.g., 'country:US'), city:NAME, org:OrganizationName, port:NUMBER, product:NAME, os:NAME, hostname:DOMAIN, net:CIDR (e.g., 'net:192.168.0.0/16'), asn:NUMBER, has_screenshot:true, has_ssl:true, has_vuln:true, vuln:CVE-ID (e.g., 'vuln:CVE-2014-0160'), http.title:PageTitle, http.status:CODE, ssl.cert.subject.cn:DOMAIN, hash:NUMBER (banner hash). Use quotes for multi-word values. Example: 'apache country:US port:443 has_ssl:true' or 'org:Amazon product:nginx'

  • facetsstring

    Comma-separated list of properties to get summary information. Available facets: country, city, org, isp, port, asn, product, version, os, domain, link, cloud.provider, cloud.region, cloud.service. Example: 'country,port,org'

  • limitnumber, default 10, 1 to 20

    Number of results to keep from the page (Shodan returns up to 100 per page, max 20 kept)

  • offsetinteger, default 0, 0 to 9007199254740991

    Number of results to skip, counted from the start of `page`. Pass the previous `nextOffset` (with `page` omitted) to walk every result; a new Shodan page is only fetched when crossing a multiple of 100

  • pagenumber, default 1, Min 1

    Shodan page of 100 results to start from (each Shodan page fetched costs a query credit)