欧博ABG官网-欧博官方网址-会员登入

API Documentation V2

The MAC Lookup Rest API is available for free and provides a powerful tool for retrieving detailed information about any MAC address or OUI (Organizationally Unique Identifier).

With this API, you can seamlessly integrate MAC address and OUI lookup functionality into your applications, services, or systems.

Key features of our MAC Lookup Rest API include:

High Volume Support: Designed to handle a high volume of requests efficiently, our API is suitable for projects of any scale.

Low Latency: We prioritize low latency to ensure that you get fast responses to your queries, allowing your applications to perform at their best.

Rich Data: Our database contains extensive information about MAC addresses and OUIs, including vendor details, address types, and more.

User-Friendly: The API is easy to use and integrate into your applications, with comprehensive documentation and support available.

This documentation is intended for developers who want to query MACLookup API.

Available API Endpoints

Get full info of a MAC

Request

Response

Example

Get Company name by MAC

Request

Example

API Resources

Response code Response code   Description  
200 (OK)   Indicates that the client’s request was accepted successfully.  
400 (Bad Request)   It is the generic client-side error status, used when no other 4xx error code is appropriate. Errors can be like malformed request syntax, invalid request message parameters, or deceptive request routing etc. The client SHOULD NOT repeat the request without modifications.  
401 (Unauthorized)   Bad API Key.  
429 (Too Many Requests)   The user has sent too many requests in a given amount of time. See Rate limits for more information  

Get full info

Retrieve full information by MAC address.

To run a query, you must submit a request, specify a data format and some optional topics, and receive a formatted response in one of the following formats:

JSON

JSONP

XML

This endpoint accepts the entire MAC address or the first six characters. The MAC address may contain separators such as "-", ":" or ".".
If it's not found, we'll send a "404".

Request

GET   https://api.maclookup.app/v2/macs/{mac_address}  

Field   Description  
{mac_address}   MAC address or a substring (min 6 chars).Valid mac address are:

- 00:00:00 or 00-00-00 or 00.00.00 or 000000

- 00:00:00:00:00:00 or 00-00-00-00-00-00 or 00.00.00.00.00.00

 
Query parameter   Description   Optional  
format   Output format.
Default output is json
Valid values:

json

jsonp

xml

  Y  
callback   function which should be executed when the request returns.
If it's not set the default response is "_cb"   Y  
apiKey   The API key is a unique identifier that is used to authenticate requests associated with your project for usage.
API Key is not mandatory but it's recommended. Get an API Key   Y  
Response Query parameter Field   Description  
success   If the request is valid status is true".  
found   When a MAC has a vendor, found is true  
mac   MAC prefix  
company   Company Name  
address   Company Address  
blockStart   Start MAC range  
blockEnd   End MAC range  
blockSize   Number of possible unique MAC for this prefix  
blockType   Assignment Type MA-L: MAC Address Block Large (previously named OUI). Number of address 2^24 (~16 Million)   MA-M: MAC Address Block Medium. Number of address 2^20 (~1 Million)   MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address 2^12 (4096)   CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address 2^24 (~16 Million)  
 
updated   When MAC information was last updated. Format (YYYY-MM-DD)  
isRand   This MAC can be transmitted when a device is not associated with an access point. In this case, it can be considered randomized  
isPrivate   The company prevents their name and address from showing up in the public listing  
Example

Example: GET   https://api.maclookup.app/v2/macs/00:00:00:00:00:00?apiKey=abcdefgh123456780  
CodeResponse
200 { "success": true,aaaaaaaaaa "found": true, "macPrefix": "000000", "company": "XEROX CORPORATION", "address": "M/S 105-50C, WEBSTER NY 14580, US", "country": "US", "blockStart": "000000000000", "blockEnd": "000000FFFFFF", "blockSize": 16777215, "blockType": "MA-L", "updated": "2015-11-17", "isRand": false, "isPrivate": false }  
400 { "success": false, "error": "MAC must be greater than 5 chars", "errorCode": 101, "moreInfo": "https://maclookup.app/api-v2/documentation" }  
401 { "success": false, "error": "Unauthorized", "errorCode": 401, "moreInfo": "https://maclookup.app/api-v2/profiles" }  
429 { "success": false, "error": "Too Many Requests", "errorCode": 429, "moreInfo": "https://maclookup.app/api-v2/rate-limits" }  

Example: GET   https://api.maclookup.app/v2/macs/00:00:00:00:00:00  
CodeResponse
200{ "success": true, "found": true, "macPrefix": "000000", "company": "XEROX CORPORATION", "address": "M/S 105-50C, WEBSTER NY 14580, US", "country": "US", "blockStart": "000000000000", "blockEnd": "000000FFFFFF", "blockSize": 16777215, "blockType": "MA-L", "updated": "2015-11-17", "isRand": false, "isPrivate": false }  
400{ "success": false, "error": "MAC must be greater than 5 chars", "errorCode": 101, "moreInfo": "https://maclookup.app/api-v2/documentation" }  
429{ "success": false, "error": "Too Many Requests", "errorCode": 429, "moreInfo": "https://maclookup.app/api-v2/rate-limits" }  

Example: GET   https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=jsonp&callback=foo  
CodeResponse
200foo({ "success": true, "found": true, "macPrefix": "000000", "company": "XEROX CORPORATION", "address": "M/S 105-50C, WEBSTER NY 14580, US", "country": "US", "blockStart": "000000000000", "blockEnd": "000000FFFFFF", "blockSize": 16777215, "blockType": "MA-L", "updated": "2015-11-17", "isRand": false, "isPrivate": false });  
400foo({ "success": false, "error": "MAC must be greater than 5 chars", "errorCode": 101, "moreInfo": "https://maclookup.app/api-v2/documentation" });  
429foo({ "success": false, "error": "Too Many Requests", "errorCode": 429, "moreInfo": "https://maclookup.app/api-v2/rate-limits" });  

Example: GET   https://api.maclookup.app/v2/macs/00:00:00:00:00:00?format=xml  
CodeResponse
200<response> <success>true</status> <found>true</found> <macPrefix>000000</macPrefix> <company>XEROX CORPORATION</company> <address>M/S 105-50C, WEBSTER NY 14580, US</address> <country>US</country> <blockStart>000000000000</blockStart> <blockEnd>000000FFFFFF</BlockEnd> <blockSize>16777215</blockSize> <blockType>MA-L</blockType> <updated>2015-11-17</updated> <isRand>false</isRand> <isPrivate>false</isPrivate> </response>  
400<response> <success>false</success> <error>MAC must be greater than 5 chars</error> <errorCode>101</errorCode> <moreInfo>https://maclookup.app/api-v2/documentation</moreInfo> </response>  
429<response> <success>false</success> <error>Too Many Requests</error> <errorCode>429</errorCode> <moreInfo>https://maclookup.app/api-v2/rate-limits</moreInfo> </response>  

Get Company name

Retrieve company name by MAC address.

This endpoint accepts the entire MAC address or the first six characters. The MAC address may contain separators such as "-", ":" or ".". If it is not found, it returns "*NO COMPANY*.

Request

GET   https://api.maclookup.app/v2/macs/{mac_address}/company/name  

Field   Description  
{mac_address}   MAC address or a substring (min 6 chars).Valid mac address are:

- 00:00:00 or 00-00-00 or 00.00.00 or 000000

- 00:00:00:00:00:00 or 00-00-00-00-00-00 or 00.00.00.00.00.00

 
Query parameter   Description   Optional  
apiKey   The API key is a unique identifier that is used to authenticate requests associated with your project for usage.
API Key is not mandatory but it's recommended. Get an API Key   Y  
Example

GET   https://api.maclookup.app/v2/macs/00:00:00:00:00:00/company/name  
CodeResponseNote
200XEROX CORPORATION    
200*PRIVATE*   The company prevents their name and address from showing up in the public listing  
200*NO COMPANY*   The MAC does not belong to any company  
400MAC must be greater than 5 chars    
401Bad APIKey - Unauthorized - more info: https://maclookup.app/api-v2/profiles    
409Too Many Requests - more info: https://maclookup.app/api-v2/rate-limits