IPWhois.net API
One key works for all three services. Every call needs an API key; a free key (1,000 IP, 1,000 blacklist and 1,000 MAC lookups a day, 1 request per second,…
Identity & security#anti-malware
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
One key works for all three services. Every call needs an API key; a free key (1,000 IP, 1,000 blacklist and 1,000 MAC lookups a day, 1 request per second, basic fields) is created at https://ipwhois.net/account/api. Paid plans return the full field set, allow batch calls and are metered per month: Starter 250,000 requests at 5 per second, Pro 1,500,000 at 15 per second, Business 6,000,000 at 30 per second. Prices are on https://ipwhois.net/pricing. The key goes in the X-API-Key header, in Authorization: Bearer, or in the key query parameter.
Endpoints 8
IP
- GETLook up the caller's own IP address
/ip - GETGeolocation, ISP, ASN and connection type of an IPv4 or IPv6 address
/ip/:ip - POSTLook up many IP addresses in one call (paid plans)
/ip/batch
Blacklist
- GETWhether an IP address is on a DNS blacklist
/blacklist/:ip - POSTBlacklist status of many IP addresses (paid plans)
/blacklist/batch
MAC
- GETVendor and block of a MAC address or OUI
/mac/:mac - GETOUI blocks registered to a vendor name (paid plans)
/mac/search?vendor=Cisco
Account
- GETPlan, rate limit and quota of the key. Not counted against the quota.
/usage
API details
- Base URL
https://ipwhois.net/api/v1- Authentication
- An API key in the X-API-Key header
A bearer token in the Authorization header
An API key in the key query parameter - Operations
- 8 operations on 8 pathsGET 6POST 2
- Main resources
- IP 3Blacklist 2MAC 2Account 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Ipwhois's published OpenAPI description
How to test the IPWhois.net API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the IPWhois.net API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Look up the caller's own IP address” (GET /ip), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the IPWhois.net API?
One key works for all three services. Every call needs an API key; a free key (1,000 IP, 1,000 blacklist and 1,000 MAC lookups a day, 1 request per second,… It is listed under Identity & security and has 8 endpoints.
Who publishes the IPWhois.net API?
It is listed from IPWhois.net's public API description (an OpenAPI document), not published by IPWhois.net on Swastik Codes. Anyone who controls ipwhois.net can claim the profile by adding a DNS TXT record.
What is the base URL of the IPWhois.net API?
Requests go to https://ipwhois.net/api/v1. Endpoint paths are added to this base URL.
How do I authenticate with the IPWhois.net API?
It accepts 3 methods: an API key in the X-API-Key header; A bearer token in the Authorization header; an API key in the key query parameter.
How many endpoints does the IPWhois.net API have?
8 operations on 8 paths (6 GET, 2 POST). The largest groups are IP, Blacklist, MAC, Account.
Is forking the IPWhois.net API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.