> For the complete documentation index see https://domscan.net/llms.txt. Markdown versions of every docs page are available by appending .md to the page URL.

Source: https://domscan.net/fr/docs/mac-lookup

# Recherche d'Adresse MAC

API DomScan : Identifiez les fabricants de périphériques réseau à partir des adresses MAC (recherche OUI).

Identifiez les fabricants de périphériques réseau à partir des adresses MAC (recherche OUI). Prend en charge les adresses EUI-48 et EUI-64 dans tous les formats courants. Retourne le nom du fournisseur, l'organisation, l'adresse, le pays et la classification du type de périphérique. Utile pour l'inventaire réseau, l'audit de sécurité et l'identification des périphériques.

GET /v1/mac

#### Paramètres de requête

| Paramètre | Type | Description |
| --- | --- | --- |
| mac requis | string | Adresse MAC dans n'importe quel format : `44:38:39:FF:EF:57` ((deux-points)) `44-38-39-FF-EF-57` ((tiret)) `443839FFEF57` ((simple)) |

#### Champs de réponse

| Champ | Description |
| --- | --- |
| `mac` | Adresse MAC normalisée |
| `type` | Type d'adresse (eui-48 ou eui-64) |
| `oui` | Identificateur Unique Organisationnel (premiers 3 octets) |
| `device_id` | ID du Contrôleur d'Interface Réseau (3 derniers octets) |
| `flags` | multidiffusion, administrée_localement, diffusion |
| `vendor.name` | Nom du fabricant/fournisseur |
| `vendor.organization` | Nom complet de l'organisation |
| `vendor.country` | Pays d'enregistrement |
| `vendor.device_type` | Catégorie de périphérique (le cas échéant) |

#### Cas d'utilisation

- Inventaire des périphériques réseau

- Identifiez les périphériques non autorisés sur le réseau

- Gestion et audit des actifs

- Classification des périphériques IoT

#### Exemple de requête

```bash
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/mac?mac=44:38:39:ff:ef:57"
```

```python
import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.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)")
```

#### Exemple de réponse

```json
{
  "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",
    "latency_ms": 12
  }
}
```

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

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

```javascript
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);
```

```python
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())
```

```go
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))
}
```

```ruby
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

```json
{
  "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
