Référence API

API Recherche d'Adresse MAC

Recherchez les informations du fabricant pour une adresse MAC. Utilisez cette référence pour choisir une opération et intégrer son contrat de réponse documenté.

Opérations

GET /v1/mac/info Voir la référence API

GET /v1/mac

Opération: getMacInfo Crédits et authentification: 1 Authentification requise
GET /v1/mac

Paramètres de Requête

Paramètre Type requis
mac string requis

Champs de Réponse

Champ Type
mac string
input string
type string
oui string
device_id string
flags object
flags.multicast boolean
flags.locally_administered boolean
flags.broadcast boolean
vendor object
vendor.name string | null
vendor.found boolean
vendor.organization string | null
vendor.address string | null
vendor.country string | null
vendor.device_type string | null
vendor.source string
vendor.cached boolean
vendor.cache_age_s integer | null
vendor.checked_at string
meta object

Exemple de Requête

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E"

Exemple de Réponse

{
  "mac": "string",
  "input": "string",
  "type": "eui-48",
  "oui": "string",
  "device_id": "string",
  "flags": {
    "multicast": true,
    "locally_administered": true,
    "broadcast": true
  },
  "vendor": {
    "name": "string",
    "found": true,
    "organization": "string",
    "address": "string",
    "country": "string",
    "device_type": "string",
    "source": "string",
    "cached": true,
    "cache_age_s": 1,
    "checked_at": "2026-04-15T12:00:00Z"
  },
  "meta": {}
}

GET /v1/mac/info

Opération: getMacLookupInfo Crédits et authentification: Gratuit Authentification requise
GET /v1/mac/info

Champs de Réponse

Champ Type
endpoint string
description string
parameters object
example_request string
example_response object

Exemple de Requête

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

Exemple de Réponse

{
  "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
    }
  }
}

Ressources de référence