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 le bon endpoint et voir exactement ce qu'il renvoie.

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 Crédits: 1

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"
const response = await fetch("https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/mac?mac=00%3A1A%3A2B%3A3C%3A4D%3A5E")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Exemple de réponse

{
  "mac": "00:1A:2B:3C:4D:5E",
  "input": "00:1A:2B:3C:4D:5E",
  "type": "eui-48",
  "oui": "00:1A:2B",
  "device_id": "3C:4D:5E",
  "flags": {
    "multicast": false,
    "locally_administered": false,
    "broadcast": false
  },
  "vendor": {
    "name": "Ayecom Technology Co., Ltd.",
    "found": true,
    "source": "live",
    "cached": false,
    "checked_at": "2026-10-09T10:15:30.000Z"
  },
  "meta": {
    "served_by": "pop=MAD country=ES",
    "latency_ms": 184
  }
}

Codes de statut HTTP

  • 200 OK
  • 400 Requête incorrecte
  • 401 Non autorisé
  • 402 Paiement requis
  • 429 Trop de requêtes
  • 503 Service indisponible

GET /v1/mac/info

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

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"
const response = await fetch("https://domscan.net/v1/mac/info", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/mac/info",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/mac/info", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/mac/info")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

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

Codes de statut HTTP

  • 200 OK
  • 401 Non autorisé
  • 429 Trop de requêtes

Ressources de référence