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

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

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-7142528346c29205683edfa2
Card version: 2
Updated: 2026-10-24T18:18:42.8538604+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

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

Inputs

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

Outputs

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

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u5B98\u65B9 Request URL \u4EE5 key query \u53C2\u6570\u4F20\u5E94\u7528 API key\uFF1B\u672C\u6B21\u6CA1\u6709\u5B9E\u9645 key\u3001\u767B\u5F55\u6216\u8BF7\u6C42\u3002"
  },
  "command": null,
  "entry_url": "https://api.shodan.io/shodan/host/count",
  "kind": "http_api",
  "method": "GET",
  "request_example": {
    "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"
  },
  "requirements": [
    "\u9700\u6709\u6548 Shodan API key \u4E0E\u652F\u6301\u76F8\u5E94\u65B9\u6CD5\u7684\u8D26\u6237\u6743\u9650\uFF0C\u5177\u4F53\u8BA1\u5212\u672A\u5728\u6240\u9009\u65B9\u6CD5\u8BF4\u660E\u660E\u786E\u3002",
    "\u67E5\u8BE2\u4F5C\u7528\u4E8E\u5DF2\u6536\u5F55 banner \u6570\u636E\u5E93\uFF1B\u672C\u6B21\u4E0D\u53D1\u51FA API \u8BF7\u6C42\u3001\u5B9E\u65F6\u626B\u63CF\u6216\u544A\u8B66\u901A\u77E5\u3002",
    "\u53EA\u7EDF\u8BA1\u8BFB\u53D6\uFF0C\u4E0D\u5C06\u540C\u9875\u5176\u5B83\u5199\u64CD\u4F5C\u6DF7\u5165\u6B64\u8C03\u7528\u3002"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "host/count \u660E\u786E\u4E0D\u6D88\u8017 query credits\uFF0C\u4F46\u672C\u6587\u6CA1\u6709\u8D26\u53F7/\u8D27\u5E01\u8D39\u7528\u6761\u6B3E\uFF0C\u4E0D\u63A8\u65AD\u514D\u8D39\u8BA1\u5212\u6216\u4E0D\u9650\u989D\u3002",
  "source_url": "https://developer.shodan.io/api"
}

{
  "location": "provider_server",
  "notes": "API key \u4E0E\u641C\u7D22/\u7EDF\u8BA1\u6761\u4EF6\u4F1A\u53D1\u5F80 Shodan\uFF1B\u6E90\u9875\u6CA1\u6709\u8BF7\u6C42\u65E5\u5FD7\u6216\u4FDD\u7559\u671F\u9650\u8BF4\u660E\u3002\u672C\u6B21\u672A\u63D0\u4EA4 key\u3001\u67E5\u8BE2\u8D44\u4EA7\u6216\u8C03\u7528\u544A\u8B66/\u626B\u63CF\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

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

Unknowns

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

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

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

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

Contributor-reported verification

{
  "checked_at": "2026-10-24T18:17:52.5298688\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://developer.shodan.io/api"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": "Shodan",
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "API key \u4E0E\u641C\u7D22/\u7EDF\u8BA1\u6761\u4EF6\u4F1A\u53D1\u5F80 Shodan\uFF1B\u6E90\u9875\u6CA1\u6709\u8BF7\u6C42\u65E5\u5FD7\u6216\u4FDD\u7559\u671F\u9650\u8BF4\u660E\u3002\u672C\u6B21\u672A\u63D0\u4EA4 key\u3001\u67E5\u8BE2\u8D44\u4EA7\u6216\u8C03\u7528\u544A\u8B66/\u626B\u63CF\u3002"
  },
  "description": "host/count \u7528\u4E8E\u7EDF\u8BA1 Shodan \u5DF2\u6709 banner \u6570\u636E\u5E93\u4E2D\u7684\u5339\u914D\u9879\uFF0C\u652F\u6301\u4E0E\u641C\u7D22\u76F8\u540C\u7684 query/filter \u548C facets\u3002\u5B83\u4E0D\u8868\u793A\u5BF9\u7F51\u7EDC\u76EE\u6807\u6267\u884C\u5B9E\u65F6\u626B\u63CF\uFF1B\u5B8C\u6574\u5E73\u53F0\u8FD8\u542B\u5176\u5B83\u67E5\u8BE2\u548C\u5199\u5165\u80FD\u529B\uFF0C\u672C\u5361\u53EA\u8BB0\u5F55\u7EDF\u8BA1\u8BFB\u53D6\u5951\u7EA6\uFF0C\u4E0D\u83B7\u53D6 key\u3001\u8BBF\u95EE\u771F\u5B9E\u8D44\u4EA7\u6570\u636E\u6216\u914D\u7F6E\u544A\u8B66\u3002",
  "inputs": [
    "query \u4E3A Shodan \u641C\u7D22\u5B57\u7B26\u4E32\uFF0C\u53EF\u7528 filter:value \u8FC7\u6EE4\u6570\u636E\u5E93\u3002",
    "\u53EF\u9009 facets \u4E3A\u9017\u53F7\u5206\u9694\u5C5E\u6027\uFF1Bproperty:count \u53EF\u6307\u5B9A\u8BE5\u5C5E\u6027\u8FD4\u56DE\u7684 facet \u9879\u6570\u3002",
    "\u5177\u4F53\u53EF\u7528 filter/facet \u6E05\u5355\u5728\u5F15\u7528\u9875\uFF0C\u672C\u6587\u4E0D\u4FDD\u8BC1\u4EFB\u610F\u5C5E\u6027\u5747\u6709\u6548\u3002"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u5B98\u65B9 Request URL \u4EE5 key query \u53C2\u6570\u4F20\u5E94\u7528 API key\uFF1B\u672C\u6B21\u6CA1\u6709\u5B9E\u9645 key\u3001\u767B\u5F55\u6216\u8BF7\u6C42\u3002"
    },
    "command": null,
    "entry_url": "https://api.shodan.io/shodan/host/count",
    "kind": "http_api",
    "method": "GET",
    "request_example": {
      "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"
    },
    "requirements": [
      "\u9700\u6709\u6548 Shodan API key \u4E0E\u652F\u6301\u76F8\u5E94\u65B9\u6CD5\u7684\u8D26\u6237\u6743\u9650\uFF0C\u5177\u4F53\u8BA1\u5212\u672A\u5728\u6240\u9009\u65B9\u6CD5\u8BF4\u660E\u660E\u786E\u3002",
      "\u67E5\u8BE2\u4F5C\u7528\u4E8E\u5DF2\u6536\u5F55 banner \u6570\u636E\u5E93\uFF1B\u672C\u6B21\u4E0D\u53D1\u51FA API \u8BF7\u6C42\u3001\u5B9E\u65F6\u626B\u63CF\u6216\u544A\u8B66\u901A\u77E5\u3002",
      "\u53EA\u7EDF\u8BA1\u8BFB\u53D6\uFF0C\u4E0D\u5C06\u540C\u9875\u5176\u5B83\u5199\u64CD\u4F5C\u6DF7\u5165\u6B64\u8C03\u7528\u3002"
    ]
  },
  "limitations": [
    "host/count \u4E0D\u6D88\u8017 query credits \u4EC5\u662F\u914D\u989D\u8BF4\u660E\uFF0C\u4E0D\u4EE3\u8868\u8D26\u53F7/\u670D\u52A1\u5B8C\u5168\u514D\u8D39\u6216\u65E0\u9650\u901F\u3002",
    "\u540C\u9875 host/search \u82E5\u67E5\u8BE2\u5E26 filter \u6216\u8BFB\u8FC7\u7B2C\u4E00\u9875\u53EF\u80FD\u6263 query credit\uFF0C\u4E0D\u80FD\u628A count \u89C4\u5219\u5957\u7528\u5230\u641C\u7D22\u3002",
    "banner \u6570\u636E\u53CD\u6620\u5DF2\u6536\u5F55\u7684\u89C2\u6D4B\u4FE1\u606F\uFF0C\u4E0D\u80FD\u4F5C\u4E3A\u5F53\u524D\u4E3B\u673A\u53EF\u8FBE\u6027\u3001\u6F0F\u6D1E\u6216\u5B8C\u6574\u8D44\u4EA7\u6E05\u5355\u9A8C\u8BC1\u3002",
    "\u672C\u6279\u672A\u660E\u786E\u8BE5\u65B9\u6CD5\u7684\u8D27\u5E01\u4EF7\u683C\u3001\u8D26\u53F7\u8BA1\u5212\u3001\u8BF7\u6C42\u901F\u7387\u3001\u603B\u914D\u989D\u6216 SLA\u3002"
  ],
  "outputs": [
    "count \u8FD4\u56DE total \u5339\u914D\u6570\u53CA\u8BF7\u6C42\u7684 facets\uFF1Bmatches \u4E3A\u7A7A\u6570\u7EC4\uFF0C\u4E0D\u542B\u4E3B\u673A\u660E\u7EC6\u3002",
    "facet \u9879\u4E3A count/value \u5BF9\uFF1B\u5386\u53F2\u793A\u4F8B\u4E2D\u7684\u7EC4\u7EC7\u548C\u6570\u91CF\u4E0D\u662F\u672C\u6B21\u5B9E\u65F6\u7EDF\u8BA1\u3002"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "host/count \u660E\u786E\u4E0D\u6D88\u8017 query credits\uFF0C\u4F46\u672C\u6587\u6CA1\u6709\u8D26\u53F7/\u8D27\u5E01\u8D39\u7528\u6761\u6B3E\uFF0C\u4E0D\u63A8\u65AD\u514D\u8D39\u8BA1\u5212\u6216\u4E0D\u9650\u989D\u3002",
    "source_url": "https://developer.shodan.io/api"
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "official_documentation",
      "checked_at": "2026-10-25T02:17:52.5298688\u002B08:00",
      "title": "Shodan Developer",
      "url": "https://developer.shodan.io/api"
    }
  ],
  "summary": "Shodan \u5B98\u65B9 REST \u53C2\u8003\u63D0\u4F9B HTTPS \u67E5\u8BE2\u63A5\u53E3\uFF1B\u672C\u5361\u91C7\u7528 host/count\uFF0C\u53EA\u8FD4\u56DE\u5339\u914D\u603B\u6570\u4E0E facet \u7EDF\u8BA1\uFF0C\u4E0D\u8FD4\u56DE\u4E3B\u673A\u7ED3\u679C\uFF0C\u6587\u6863\u79F0\u4E0D\u6D88\u8017 query credits\u3002\u9700 API key\uFF1B\u8D27\u5E01\u4EF7\u683C\u3001\u8D26\u53F7\u8BA1\u5212\u548C\u901F\u7387\u989D\u5EA6\u672A\u77E5\uFF0C\u672A\u67E5\u8BE2\u6216\u53D1\u8D77\u626B\u63CF\u3002",
  "tags": [
    "http_api",
    "documentation_only",
    "internet_service_statistics"
  ],
  "terms_url": null,
  "title": "Shodan REST API\uFF1A\u4E92\u8054\u7F51\u670D\u52A1\u7EDF\u8BA1\u67E5\u8BE2",
  "unknowns": [
    "\u771F\u5B9E\u8D26\u53F7\u6743\u9650\u3001\u8D27\u5E01\u8D39\u7528\u3001\u901F\u7387/\u914D\u989D\u3001SLA\u3001\u65E5\u5FD7\u4FDD\u7559\u4E0E\u6570\u636E\u518D\u5229\u7528\u8BB8\u53EF\u672A\u77E5\u3002",
    "\u5F53\u524D\u6570\u636E\u5E93\u8986\u76D6/\u66F4\u65B0\u53CA\u5B9E\u9645\u7EDF\u8BA1\u7ED3\u679C\u672A\u9A8C\u8BC1\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T18:17:52.5298688\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://developer.shodan.io/api"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-7142528346c29205683edfa2",
  "version": 2,
  "source_url": "https://developer.shodan.io/api",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "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"
    ]
  },
  "created_at": "2026-10-24T18:17:55.5932633\u002B00:00",
  "updated_at": "2026-10-24T18:18:42.8538604\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-7142528346c29205683edfa2?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-7142528346c29205683edfa2?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u4E92\u8054\u7F51\u89C2\u6D4B\uFF0FShodan \u5DF2\u6536\u5F55\u670D\u52A1\u7684\u805A\u5408\u7EDF\u8BA1",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-449a3fbe94ead38385fecf83d0e73325",
        "source_url": "https://developer.shodan.io/api",
        "content_sha256": "dc1940b0eb4b964cf5130e796cf88cd296455ceb553052781c41cbf2aef51e7f",
        "decoded_bytes": 179819,
        "content_type": "text/html",
        "captured_at": "2026-10-24T18:17:52.5298688\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "dc1940b0eb4b964cf5130e796cf88cd296455ceb553052781c41cbf2aef51e7f",
        "text_utf8_bytes": 179819,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-7142528346c29205683edfa2/materials/material-449a3fbe94ead38385fecf83d0e73325?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-c649a6fff4e747c2975ffdc9ca113a9b",
    "reason": "\u4F9D\u636E\u672C\u6279 Shodan REST \u53C2\u8003\u7684\u660E\u786E HTTPS base\u3001host/count GET\u3001key/query/facets\u3001\u7A7A matches \u53CA\u4E0D\u6D88\u8017 query credits \u8BF4\u660E\u6574\u7406\uFF0C\u79FB\u9664\u672A\u6574\u7406\u6807\u7B7E\u3002\u4EC5 documentation_only\uFF0C\u672A\u8C03\u7528\u3001\u626B\u63CF\u6216\u5EFA\u7ACB\u544A\u8B66\uFF1B\u8D39\u7528\u4E0E\u771F\u5B9E\u989D\u5EA6\u4FDD\u672A\u77E5\u3002",
    "source_urls": [
      "https://developer.shodan.io/api"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-7142528346c29205683edfa2",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-7142528346c29205683edfa2?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-7142528346c29205683edfa2?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure