Skip to content

Latest commit

 

History

History
261 lines (182 loc) · 9.25 KB

README.md

File metadata and controls

261 lines (182 loc) · 9.25 KB
Raw

MAC Address Lookup

MAC address lookup by troubleshooting.tools resolves the entered MAC/OUI/CID/IAB address to the assign vendor including additional information like vendor name, address, block category, size and range.

Content

  1. ) Web page
  2. ) Webhook
  3. ) Open Graph
  4. ) OpenSearch
  5. ) HTML search form
  6. ) API
  7. ) Limitations and caveats

1.) Web page

Look up single MAC address

  1. Visit with a web browser https://troubleshooting.tools/lookup/mac/
  2. Enter a MAC address in the search form
  3. Hit enter key or submit button

Look up multiple MAC addresses simultaneously

  1. Visit with a web browser https://troubleshooting.tools/multi/lookup/mac/
  2. Paste the ARP table that has been copied from the Windows CMD, MAC/Linux terminal or similar in the search form
  3. Hit enter key or submit button

2.) Webhook

Beside the classic form input on the web page, the web page supports also webhooks. This possibility is ideal to share a link and guide the recipient directly to the results.

URL: https://troubleshooting.tools/lookup/mac/ {mac_address}

Example: https://troubleshooting.tools/lookup/mac/B8F2551F2E3D

3.) Open Graph

Sharing the Webhook link into a web page or app that support the Open Graph protocol gives the opportunity to share a small excerpt of the results, without that the recipient need to visit the webpage itself.

Examples

Slack:

Discord:

Mattermost:

WhatsApp:

Telegram:

Twitter:

4.) Open Search

The browser integration of troubleshooting.tools allows to use the browser address bar as a search input field, when needed, without visiting the original web page before.

This function is called OpenSearch and works with Apple Safari, Microsoft Edge, Mozilla Firefox and Google Chrome. Before we can start using it, we have to setup our browser for this function. Here an example for Google Chrome:

At the top right, click More and then Settings.

Under "Search engine," click Manage search engines.

To the right of "Other search engines," click Add.

Fill out the text fields as shown below and click Add.

Search engine:
Enter troubleshooting.tools or a name of your choice.

Keyword:
Enter the character "t" or a keyword of your choice, to trigger later the search function.

URL with %s in place of query:
https://troubleshooting.tools/lookup/mac/%s






The setup is complete. You are still able to continue to enter a URL in the address bar or any search terms that trigger a Google search.

The new feature is, if you enter an "t" followed by a space, then you activate the troubleshooting.tools search.

This cause that Google Chrome address bar react like the search field on this website.

5.) HTML search form

To integrate the search bar into a different web page a few line are needed. The look and feel can be adjusted as desired.

<form method="post" action="https://troubleshooting.tools/lookup/mac/">
  <input type="text" name="MACADDRESS" placeholder="">
  <input type="submit" value="&#128269;">
</form>

6.) API

The MAC Address Lookup API allows you to search for details about a MAC address, including the associated vendor and additional information based on the size of the MAC address block. The API supports both Plaintext and JSON responses and can handle multiple MAC addresses in a single request.

Features:

  • Plaintext Response: Returns just the vendor name.
  • JSON Response: Returns detailed information, including OUI, block category, block size, block range (start and end addresses), vendor name, and vendor address.
  • Support for Multiple MAC Addresses: You can input multiple MAC addresses using commas as delimiter.
  • MAC Address Validation: The API validates the input MAC address, normalizing it to remove any separators (colons, hyphens, etc.) before searching.

Input Format:

  • The API accepts MAC addresses in various formats, including:
    • C4:C1:7D:7F:EA:DC
    • C4-C1-7D-7F-EA-DC
    • C4C17D-7FEADC
    • C4C17D7FEADC
    • C4C1.7D7F.EADC
  • The first 6, 7, or 9 hexadecimal digits are used to search against the OUI database, depending on the size of the MAC address block.
Format Level URL Output
Plaintext 0 https://api.troubleshooting.tools/lookup/mac/ {mac_address} Returns the vendor name for the provided MAC address.
JSON 0 https://api.troubleshooting.tools/lookup/mac/json/ {mac_address} Returns the detailed information including OUI, block category, block size, block range, vendor name, and vendor address.

Plaintext Example:

Endpoint:
https://api.troubleshooting.tools/lookup/mac/{macaddress}
Example Request::
curl -X GET https://api.troubleshooting.tools/lookup/mac/C4C17D7FEADC
Example Response:
Apple, Inc.
Note:
  • If multiple MAC addresses are provided in a Plaintext request (separated by commas), each MAC address and its associated vendor will be returned.
  • Example for multiple MAC addresses: 
    C4C17D7FEADC: Apple, Inc.
007041F85E38: OUI not found for the provided MAC address.

JSON Example:

Endpoint:
https://api.troubleshooting.tools/lookup/mac/json/{macaddress}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/mac/json/C4C17D7FEADC
Example Response:
[
  {
    "mac": "C4C17D7FEADC",
    "oui": "C4C17D",
    "vendor": "Apple, Inc.",
    "organization_address": "1 Infinite Loop Cupertino CA US 95014",
    "assignment_type": "MA-L",
    "block_size": 16777216,
    "start_address": "C4:C1:7D:00:00:00",
    "end_address": "C4:C1:7D:FF:FF:FF"
  }
]
Endpoint:
https://api.troubleshooting.tools/lookup/mac/json/{macaddress_1},{macaddress_2}
Example Request:
curl -X GET https://api.troubleshooting.tools/lookup/mac/json/C4C17D7FEADC,007041F85E38
Example Response:
[
  {
    "mac": "C4C17D7FEADC",
    "oui": "C4C17D",
    "vendor": "Apple, Inc.",
    "organization_address": "1 Infinite Loop Cupertino CA US 95014",
    "assignment_type": "MA-L",
    "block_size": 16777216,
    "start_address": "C4:C1:7D:00:00:00",
    "end_address": "C4:C1:7D:FF:FF:FF"
  },
  {
    "mac": "007041F85E38",
    "error": "OUI not found for the provided MAC address."
  }
]

Error Handling:

  • Invalid MAC address format

    • An error message will be triggered if the input cannot be recognized as a valid MAC address.

  • OUI not found for the provided MAC address

    • The entered MAC address has a valid format, but no match was found in the database.

  • Incomplete vendor information. Please provide a full MAC address

    • The block was assigned by the IEEE to several vendors. To obtain accurate results, the 7th to 9th digits, or preferably the complete MAC address, are required.

  • HTTP 429: Too Many Requests

    • Rate limit: 250 requests per second.
    • This limit may be adjusted without prior notice based on server resource demand.

All mentioned trademarks are the property of their respective owners.