MAC Lookup API

A fast, free REST API for MAC address & OUI vendor lookups. No key required to get started; register a key for a higher rate limit.

Endpoint

GET https://macdetect.com/api/mac/{mac}

{mac} may be a full MAC or a 6–12 character OUI, with or without separators — e.g. 001A2B, 00:1A:2B:3C:4D:5E, 00-1A-2B.

Example

curl https://macdetect.com/api/mac/001A2B3C4D5E

{
  "found": true,
  "mac": "00:1A:2B:3C:4D:5E",
  "oui": "00:1A:2B",
  "vendor": "Apple, Inc.",
  "vendor_slug": "apple",
  "block_type": "MA-L",
  "country": "US",
  "administration": "UAA",
  "transmission": "unicast"
}

Authentication & rate limits

Anonymous requests are limited per IP per day. Pass an API key for a higher limit, either as a header or a query parameter:

curl -H "X-API-Key: md_your_key_here" https://macdetect.com/api/mac/001A2B
# or
curl "https://macdetect.com/api/mac/001A2B?key=md_your_key_here"

Every response includes X-RateLimit-Limit and X-RateLimit-Remaining headers. Exceeding the limit returns HTTP 429.

Code samples

// JavaScript
const r = await fetch("https://macdetect.com/api/mac/001A2B3C4D5E");
const data = await r.json();
console.log(data.vendor);

// PHP
$data = json_decode(file_get_contents("https://macdetect.com/api/mac/001A2B"), true);
echo $data["vendor"];

# Python
import requests
print(requests.get("https://macdetect.com/api/mac/001A2B").json()["vendor"])