Entity Object

The Entity (entity ) object provides normalized organization metadata, including a unique ID, tag, description, and associated logos. We use this object to represent organizations behind ASNs, Mobile Gateways, and MAC address prefixes (OUIs), creating a consistent identity layer across datasets and APIs.

For example, if an IP address belongs to ASN AS210492 - Nintendo European Research and Development - the IP API returns the corresponding Nintendo entity object.

Entity Object - Visualized

ID: 10046
Tag: nintendo
Label: Nintendo
Category: Games
Home Page: Nintendo - Home Page
Logo: Nintendo

Entity Logos

Three types of logos are available in the data payload. The favicon and icon can vary in size, but these images will render well at the sizes described below. The logo , if available, is strictly 128x128.

Favicon: A logo that renders well at 16x16
Icon: A logo that renders well at 128x128
Logo: A logo that is exactly 128x128 (if available)

Not all applications have all of the logos available. By default, the API response will provide a placeholder logo showing the first letter of the app, e.g., .

In the data payload, you can check the values for favicon_source , icon_source , and logo_source to verify the source of the images. If the source is set to app , the actual application logo is available. If the source is set to default , the placeholder image is provided.

Entity Attributes

id

integer

The ID number associated with the entity.

tag

string

The tag associated with the entity. You can browse the list of tags on the applications web tool or, you can fetch the list by querying the API.

label

string

This is the name an end user would typically use to identify the entity.

full_label

string

The full_label (if shown) provides a more formal name. For example, BBC is the label, but British Broadcasting Corporation is the full_label.

description

string

A one or two-sentence description of the entity.

home_page

object

A small object that defines both the url and associated text for the entity home page.

favicon

string

URL for the entity favicon.

icon

string

URL for the entity icon.

logo

string

URL for the entity logo.

favicon_source

string

Source of the favicon, either app or default.

icon_source

string

Source of the icon, either app or default.

logo_source

string

Source of the logo, either app or default.

Entity Object - JSON Example

"entity": {
    "id": 10046,
    "tag": "nintendo",
    "label": "Nintendo",
    "description": "Nintendo is the home ...",
    "home_page": {
        "url": "https://www.nintendo.com",
        "text": "Nintendo"
    },
    "category": {
        "id": 12,
        "tag": "games",
        "label": "Games"
    },
    "favicon": "https://static.netify.ai...",
    "icon": "https://static.netify.ai...",
    "logo": "https://static.netify.ai...",
    "favicon_source": "app",
    "icon_source": "app",
    "logo_source": "app"
}