Censys · JSON Structure

Platform Host Structure

Host schema from Censys Platform API

Type: object Properties: 14

SecurityInternet IntelligenceAttack Surface ManagementThreat HuntingCyber Threat IntelligenceOSINTInternet ScanningCertificatesAsset Discovery

Host is a JSON Structure definition published by Censys, describing 14 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

autonomous_system dns greynoise hardware ip labels location network operating_system privacy reputation service_count services whois

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/censys/refs/heads/main/json-structure/platform-host-structure.json",
  "name": "Host",
  "description": "Host schema from Censys Platform API",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "autonomous_system": {
      "$ref": "#/components/schemas/Routing"
    },
    "dns": {
      "$ref": "#/components/schemas/HostDns"
    },
    "greynoise": {
      "$ref": "#/components/schemas/Greynoise"
    },
    "hardware": {
      "$ref": "#/components/schemas/Attribute"
    },
    "ip": {
      "type": "string"
    },
    "labels": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/components/schemas/Label"
      }
    },
    "location": {
      "$ref": "#/components/schemas/Location"
    },
    "network": {
      "type": [
        "array",
        "null"
      ],
      "description": "Information about what type of network the host belongs to.",
      "items": {
        "$ref": "#/components/schemas/NetworkClassification"
      }
    },
    "operating_system": {
      "$ref": "#/components/schemas/Attribute"
    },
    "privacy": {
      "type": [
        "array",
        "null"
      ],
      "description": "Information about privacy services used by the IP, such as VPNs, Proxies, or Tor.",
      "items": {
        "$ref": "#/components/schemas/Privacy"
      }
    },
    "reputation": {
      "$ref": "#/components/schemas/Reputation"
    },
    "service_count": {
      "type": "int32"
    },
    "services": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "$ref": "#/components/schemas/Service"
      }
    },
    "whois": {
      "$ref": "#/components/schemas/Whois"
    }
  }
}