Shodan · Schema

Shodan Streaming Banner

Banner event emitted by the Shodan streaming firehose. Same shape as the REST banner.

SecuritySearchInternetDevicesIoTVulnerabilitiesCVEAttack SurfaceThreat IntelligenceReconnaissanceNetworkDNSScanningPublic APIs

Properties

Name Type Description
ip_str string
port integer
transport string
product string
version string
data string
timestamp string
hash integer
org string
isp string
asn string
hostnames array
domains array
location object
ssl object
http object
cpe23 array
vulns object
tags array
View JSON Schema on GitHub

JSON Schema

shodan-stream-banner-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://github.com/api-evangelist/shodan/json-schema/shodan-stream-banner-schema.json",
  "title": "Shodan Streaming Banner",
  "description": "Banner event emitted by the Shodan streaming firehose. Same shape as the REST banner.",
  "type": "object",
  "required": ["ip_str", "port", "transport", "data", "timestamp"],
  "properties": {
    "ip_str": { "type": "string" },
    "port": { "type": "integer", "minimum": 0, "maximum": 65535 },
    "transport": { "type": "string", "enum": ["tcp", "udp"] },
    "product": { "type": "string" },
    "version": { "type": "string" },
    "data": { "type": "string" },
    "timestamp": { "type": "string", "format": "date-time" },
    "hash": { "type": "integer" },
    "org": { "type": "string" },
    "isp": { "type": "string" },
    "asn": { "type": "string" },
    "hostnames": { "type": "array", "items": { "type": "string" } },
    "domains": { "type": "array", "items": { "type": "string" } },
    "location": {
      "type": "object",
      "properties": {
        "city": { "type": ["string", "null"] },
        "country_code": { "type": ["string", "null"] },
        "country_name": { "type": ["string", "null"] },
        "latitude": { "type": ["number", "null"] },
        "longitude": { "type": ["number", "null"] }
      }
    },
    "ssl": { "type": "object", "additionalProperties": true },
    "http": { "type": "object", "additionalProperties": true },
    "cpe23": { "type": "array", "items": { "type": "string" } },
    "vulns": { "type": "object", "additionalProperties": true },
    "tags": { "type": "array", "items": { "type": "string" } }
  }
}