> 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/ru/docs/products/mac-lookup

# API Поиск MAC адреса

Посмотрите информацию о производителе для MAC адреса. Используйте этот справочник, чтобы выбрать нужный эндпоинт и точно увидеть, что он возвращает.

[Открыть страницу продукта](https://domscan.net/ru/mac-address-lookup-api)

## Операции

GET `/v1/mac` [Открыть справочник API](https://domscan.net/ru/docs/products/mac-lookup#getMacInfo)

GET `/v1/mac/info` [Открыть справочник API](https://domscan.net/ru/docs/products/mac-lookup#getMacLookupInfo)

## GET `/v1/mac`

Операция: `getMacInfo`
Кредиты и аутентификация: 1
Требуется аутентификация

GET /v1/mac Кредиты: 1

#### Параметры запроса

| Параметр | Тип | обязателен |
| --- | --- | --- |
| 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 |

#### Пример запроса

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

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

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

```go
package main

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"))

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

#### Пример ответа

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

- `200` OK
- `400` Неверный запрос
- `401` Не авторизован
- `402` Требуется оплата
- `429` Слишком много запросов
- `503` Сервис недоступен

## GET `/v1/mac/info`

Операция: `getMacLookupInfo`
Кредиты и аутентификация: Бесплатно
Требуется аутентификация

GET /v1/mac/info Кредиты: 0

#### Поля ответа

| Поле | Тип |
| --- | --- |
| `endpoint` | string |
| `description` | string |
| `parameters` | object |
| `example_request` | string |
| `example_response` | object |

#### Пример запроса

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

#### Пример ответа

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

#### Коды состояния HTTP

- `200` OK
- `401` Не авторизован
- `429` Слишком много запросов

## Справочные материалы

[OpenAPI 3.0](https://domscan.net/v1/openapi.json)
[Postman](https://domscan.net/v1/postman.json)
[MCP](https://domscan.net/ru/mcp-domain-checker)
