Hostname Object

The Hostname object is returned in the Hostname API.

Object Information

Application

The application property provides the application information associated with the hostname. Details: application property.

Platform - CDN / Hosting / SaaS

The platform JSON block provides the platform related to the hostname. "Platform" is a generic term we use for a CDN, hosting, and SaaS providers. The JSON format is identical to the application property.

Network

The network is provided if all the IP addresses associated with the hostname point to a single platform. The format is identical to the application property.

FAQ: What is a Network?

ASN

The asn (Autonomous System Number) is provided if all the IP addresses associated with the hostname point to a single ASN. Details: ASN property.

IPs

The ips property provides a list of IP addresses associated with the hostname. Typically, this information comes from DNS data, but it can also be derived from TLS certificates and other deep packet inspection data. You can use the IP API to retrieve IP address details.

Hostname Object - Visualized

Hostname shop.ring.com
Application Ring - Logo Ring
Platform Shopify - Logo Shopify
Network Cloudflare - Logo Cloudflare
IPs - 23.227.38.74
- 2620:127:f00f:e::

Hostname Object - JSON Overview

{
    "hostname": "www.example.com",
    { Application Property },
    { Platform Property },
    { Network Property },
    { ASN Property },
    "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::",
      ...
    ],
}

Integration and Custom Solutions

Do you have any questions about integration, APIs or custom development?

Contact Us