Hostname Object

The Hostname object is returned by the Hostname API. It links a hostname to the detected application, platform, network, ASN and resolved IPs.

Hostname Attributes

hostname

string

The fully qualified hostname, e.g. www.example.com.

application

object - Application Object

The application object associated with the hostname.

platform

object - Application Object (similar)

Platform provides CDN, hosting or SaaS provider information.

network

object - Network Object

Network information, provided when the hostname resolves to IPs belonging to a single network.

asn

object - ASN Object

Autonomous System Number (ASN) information when IPs mapped to the hostname belong to a single ASN.

ips

array

A list of IP addresses associated with the hostname. Typically sourced from DNS, TLS certificates, or packet inspection. Use the IP API to fetch detailed IP objects.

Hostname Object - JSON Overview

{
    "hostname": "www.example.com",
    "application": { Application Attributes },
    "platform": { Platform Attributes },
    "network": { Network Attributes },
    "asn": { ASN Attributes },
    "ips": [ 
        "23.227.38.74",
        "2620:127:f00f:e::",
        ...
    ]
}

Hostname Object - JSON Example

{
    "hostname": "au-en.ring.com",
    "application": {
      "id": 10438,
      "tag": "ring",
      "label": "Ring",
      "description": "Ring is a...",
      "category": {
        "id": 33,
        "tag": "device-iot",
        "label": "Device/IoT"
      },
      ...
    },
    "platform": {
      "id": 10035,
      "tag": "shopify",
      "label": "Shopify",
      "description": "Shopify is an...",
      "category": {
        "id": 23,
        "tag": "shopping",
        "label": "Shopping"
      },
      ...
    },
    "network": {
      "id": 206,
      "tag": "cloudflare",
      "label": "Cloudflare",
      "description": "Cloudflare is ...",
      "category": {
        "id": 35,
        "tag": "cdn",
        "label": "CDN"
      },
      ...
    },
    "asn": {
      "tag": "AS13335",
      "label": "Cloudflare",
      "entity": {
        "id": 206,
        "tag": "cloudflare",
        "label": "Cloudflare",
        "category": {
          "id": 35,
          "tag": "cdn",
          "label": "CDN"
        }
        ...
      }
    },
    "ips": [
      "23.227.38.74",
      "2620:127:f00f:e::",
      ...
    ],
}