API 参考

MAC 地址查询 API 参考

查询 MAC 地址的制造商信息。使用此参考选择操作，并集成其文档化的响应契约。

查看产品页

操作

GET /v1/mac 查看 API 参考

GET /v1/mac/info 查看 API 参考

GET `/v1/mac`

操作: getMacInfo 积分和身份验证: 1 需要身份验证

GET /v1/mac

查询参数

参数	类型	必需
mac	string	必需

响应字段

字段	类型
`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

请求示例

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

响应示例

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

操作: getMacLookupInfo 积分和身份验证: 免费需要身份验证

GET /v1/mac/info

响应字段

字段	类型
`endpoint`	string
`description`	string
`parameters`	object
`example_request`	string
`example_response`	object

请求示例

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

响应示例

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

参考资源

OpenAPI 3.0 Postman MCP