Shodan REST API：互联网服务统计查询

Shodan 官方 REST 参考提供 HTTPS 查询接口；本卡采用 host/count，只返回匹配总数与 facet 统计，不返回主机结果，文档称不消耗 query credits。需 API key；货币价格、账号计划和速率额度未知，未查询或发起扫描。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：互联网观测／Shodan 已收录服务的聚合统计 · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · dc1940b0eb4b964cf5130e796cf88cd296455ceb553052781c41cbf2aef51e7f

host/count 用于统计 Shodan 已有 banner 数据库中的匹配项，支持与搜索相同的 query/filter 和 facets。它不表示对网络目标执行实时扫描；完整平台还含其它查询和写入能力，本卡只记录统计读取契约，不获取 key、访问真实资产数据或配置告警。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-7142528346c29205683edfa2 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-7142528346c29205683edfa2
名片版本: 2
资料更新: 2026-10-24T18:18:42.8538604+00:00
原作者 / 提供者: Shodan
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

query 为 Shodan 搜索字符串，可用 filter:value 过滤数据库。
可选 facets 为逗号分隔属性；property:count 可指定该属性返回的 facet 项数。
具体可用 filter/facet 清单在引用页，本文不保证任意属性均有效。

输出

count 返回 total 匹配数及请求的 facets；matches 为空数组，不含主机明细。
facet 项为 count/value 对；历史示例中的组织和数量不是本次实时统计。

使用方式

类型: HTTP 接口
入口: 原使用入口
HTTP 方法: GET

鉴权：API 密钥。官方 Request URL 以 key query 参数传应用 API key；本次没有实际 key、登录或请求。

运行前提

需有效 Shodan API key 与支持相应方法的账户权限，具体计划未在所选方法说明明确。
查询作用于已收录 banner 数据库；本次不发出 API 请求、实时扫描或告警通知。
只统计读取，不将同页其它写操作混入此调用。

公开请求示例

{
  "method": "GET",
  "notes": "\u5B98\u65B9 count \u793A\u4F8B\uFF0C\u53E6\u9700\u771F\u5B9E key query \u53C2\u6570\uFF1B\u672A\u6267\u884C\uFF0C\u7EDF\u8BA1\u503C\u4E0D\u662F\u5F53\u524D\u7ED3\u679C\u3002",
  "query": {
    "facets": "org,os",
    "query": "port:22"
  },
  "url": "https://api.shodan.io/shodan/host/count"
}

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。host/count 明确不消耗 query credits，但本文没有账号/货币费用条款，不推断免费计划或不限额。

价格来源 · 未知

资料去向

提供者服务器。API key 与搜索/统计条件会发往 Shodan；源页没有请求日志或保留期限说明。本次未提交 key、查询资产或调用告警/扫描。

限制

host/count 不消耗 query credits 仅是配额说明，不代表账号/服务完全免费或无限速。
同页 host/search 若查询带 filter 或读过第一页可能扣 query credit，不能把 count 规则套用到搜索。
banner 数据反映已收录的观测信息，不能作为当前主机可达性、漏洞或完整资产清单验证。
本批未明确该方法的货币价格、账号计划、请求速率、总配额或 SLA。

仍需核对

真实账号权限、货币费用、速率/配额、SLA、日志保留与数据再利用许可未知。
当前数据库覆盖/更新及实际统计结果未验证。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:17:52.5298688+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Shodan Developer · 官方文档 · 2026-10-25T02:17:52.5298688+08:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developer.shodan.io/api",
  "final_url": "https://developer.shodan.io/api",
  "status_code": 200,
  "title": "Shodan Developer",
  "description": "Complete reference documentation for the Shodan API",
  "checked_at": "2026-10-24T18:17:52.5298688\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-7142528346c29205683edfa2",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developer.shodan.io/api"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。