5 Fast Ways to Run a Macvendors.co Lookup for Network Troubleshooting
Identifying device manufacturers from MAC addresses is a core task in network troubleshooting. Macvendors.co provides a simple API and web lookup service to resolve MAC prefixes (OUI) to vendor names. Below are five fast, practical methods you can use—manual web lookup, browser bookmarklet, command-line curl, Python script, and bulk CSV processing—so you can pick one that fits your workflow.
1) Quick web lookup (fastest for one-off checks)
- Go to https://macvendors.co.
- Enter the full MAC address or OUI (first 6 hex digits) in the search box and press Enter.
- Read the vendor name and additional details shown on the results page.
When to use: single addresses or quick ad-hoc checks from any device with a browser.
2) Browser bookmarklet (one-click lookup)
- Create a bookmark with this URL as the location: javascript:(function(){var m=prompt(‘MAC or OUI:’); if(!m) return; window.open(’https://macvendors.co/query/‘+encodeURIComponent(m));})();
- Click the bookmarklet, paste the MAC/OUI, and a new tab opens with the lookup results.
When to use: speed while browsing network logs or web-based management consoles.
3) Command-line curl (fast for one or scriptable checks)
- Single lookup:
Code
curl -s https://api.macvendors.co/Replacewith the MAC address or OUI (no angle brackets). Example:
Code
- The API returns vendor name in plain text. For JSON (if supported or proxied), you can parse it with jq.
When to use: quick checks from terminals, SSH sessions, or when embedding in shell scripts.
4) Python script (programmatic and repeatable)
- Example script to resolve a single MAC or a list:
python
import requests def lookup_mac(mac): url = f’https://api.macvendors.co/{mac}‘ r = requests.get(url, timeout=5) return r.text.strip() if r.status_code == 200 else None if name == ’main‘: macs = [‘44:38:39:ff:ef:57’, ‘00:1A:2B’] for m in macs: print(m, ’->’, lookupmac(m)) - Add retries, rate-limiting, or caching for production use.
When to use: integrating lookups into tools, automation, or dashboards.
5) Bulk CSV processing (scale lookups for inventory)
- Prepare a CSV with a column of MAC addresses (header: mac).
- Example Python using pandas to read, query, and save results:
python
import pandas as pd import requests import time df = pd.read_csv(‘devices.csv’) def vendor_for(mac): try: r = requests.get(f’https://api.macvendors.co/{mac}‘, timeout=5) return r.text.strip() if r.status_code == 200 else “ except: return ” df[‘vendor’] = df[‘mac’].apply(vendor_for) df.to_csv(‘devices_with_vendors.csv’, index=False) - If rate limits apply, add time.sleep between requests and consider local OUI databases for large volumes.
When to use: inventory reconciliation, audits, or network asset discovery at scale.
Practical tips and troubleshooting
- Normalize MAC formats: remove delimiters or standardize to colon-separated form for consistency.
- Use OUI (first 6 hex digits) when full MACs are unnecessary; reduces variability.
- Respect API rate limits; implement retries with exponential backoff.
- For large offline lookups, download an OUI database (IEEE or other sources) and query locally.
- If a vendor lookup returns “unknown,” the device may use a newer or virtual MAC (locally administered or randomized addresses).
Quick decision guide
- One-off check → web lookup or curl.
- Frequent manual checks → bookmarklet.
- Automation or integration → Python script.
- Large batch → CSV processing or local OUI DB.
These five methods cover from one-off ad-hoc checks to automated, large-scale processing—pick the one that matches your troubleshooting speed and scale.
Leave a Reply