Ontwikkelaarsreferentie

MAC Address Lookup API-documentatie

MAC Address Lookup API-documentatie: Identify network device manufacturers from MAC addresses (OUI lookup). Supports both EUI-48 and EUI-64 addresses in any common format. Returns vendor name, organization, address, country, and device type classification. Useful for network inventory, security auditing, and device identification.

MAC Address Lookup

Identify network device manufacturers from MAC addresses (OUI lookup). Supports both EUI-48 and EUI-64 addresses in any common format. Returns vendor name, organization, address, country, and device type classification. Useful for network inventory, security auditing, and device identification.

GET /v1/mac

Queryparameters

Parameter	Type	Beschrijving
mac vereist	string	MAC address in any format: `44:38:39:FF:EF:57` ((colon)) `44-38-39-FF-EF-57` ((dash)) `443839FFEF57` ((plain))

Antwoordvelden

Veld	Beschrijving
`mac`	Normalized MAC address
`type`	Address type (eui-48 or eui-64)
`oui`	Organizationally Unique Identifier (first 3 bytes)
`device_id`	Network Interface Controller ID (last 3 bytes)
`flags`	multicast, locally_administered, broadcast
`vendor.name`	Manufacturer/vendor name
`vendor.organization`	Full organization name
`vendor.country`	Country of registration
`vendor.device_type`	Device category (if known)

Gebruikssituaties

Network device inventory
Identify rogue devices on network
Asset management and auditing
IoT device classification

Voorbeeldverzoek

curl "https://domscan.net/v1/mac?mac=44:38:39:ff:ef:57"

import requests

response = requests.get(
    "https://domscan.net/v1/mac",
    params={"mac": "44:38:39:ff:ef:57"}
)
data = response.json()

if data['vendor']['found']:
    print(f"Vendor: {data['vendor']['name']}")
    print(f"Country: {data['vendor']['country']}")
else:
    print("Unknown vendor (not in IEEE registry)")

Voorbeeldantwoord

{
  "mac": "44:38:39:FF:EF:57",
  "input": "44:38:39:ff:ef:57",
  "type": "eui-48",
  "oui": "44:38:39",
  "device_id": "FF:EF:57",
  "flags": {
    "multicast": false,
    "locally_administered": false,
    "broadcast": false
  },
  "vendor": {
    "name": "Cumulus Networks, Inc",
    "found": true,
    "organization": "Cumulus Networks, Inc",
    "address": "650 Castro Street, Suite 120-245",
    "country": "US",
    "device_type": "networking",
    "source": "cache",
    "cached": true,
    "cache_age_s": 3600,
    "checked_at": "2025-01-15T12:00:00Z"
  },
  "meta": {
    "served_by": "pop=SJC country=US",
    "worker_version": "2.0.0",
    "latency_ms": 12
  }
}

GET /v1/mac/info

Antwoordvelden

Veld	Type
`endpoint`	string
`description`	string
`parameters`	object
`example_request`	string
`example_response`	object

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/mac/info"

Voorbeeldantwoord

{
  "endpoint": "/v1/mac",
  "description": "Lookup MAC address metadata and vendor information.",
  "parameters": {
    "mac": {
      "type": "string",
      "required": true,
      "description": "MAC address string in any common format",
      "example": "44:38:39:ff:ef:57"
    }
  },
  "example_request": "/v1/mac?mac=44:38:39:ff:ef:57",
  "example_response": {
    "mac": "44:38:39:FF:EF:57",
    "type": "eui-48",
    "oui": "44:38:39",
    "device_id": "FF:EF:57",
    "flags": {
      "multicast": false,
      "locally_administered": false,
      "broadcast": false
    },
    "vendor": {
      "name": "Cumulus Networks, Inc",
      "found": true,
      "source": "cache",
      "cached": true
    }
  }
}