MAC-adressökning API-referens
Slå upp tillverkarinformation för en MAC-adress. Använd den här referensen för att välja rätt endpoint och se exakt vad den returnerar.
Operationer
GET /v1/mac
GET
/v1/mac
Krediter: 1
Frågeparametrar
| Parameter | Typ | obligatorisk |
|---|---|---|
| mac | string | obligatorisk |
Svarsfält
| Fält | Typ |
|---|---|
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 |
Exempelbegäran
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))Exempelsvar
{
"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
}
}
HTTP-statuskoder
200OK400Felaktig begäran401Obehörig402Betalning krävs429För många begäranden503Tjänsten är inte tillgänglig
GET /v1/mac/info
GET
/v1/mac/info
Krediter: 0
Svarsfält
| Fält | Typ |
|---|---|
endpoint |
string |
description |
string |
parameters |
object |
example_request |
string |
example_response |
object |
Exempelbegäran
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))Exempelsvar
{
"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
}
}
}
HTTP-statuskoder
200OK401Obehörig429För många begäranden