The general syntaxis to make a request is https://api.ipdon.com/<ip address>?token=<API token>
When using the Free tier you don't need to specify ?token as a variable to the URL but mind you that there are limits to its use, read here to learn more about our plans. The API supports different authentication methods, click here to see how to use Header or Cookie based authentication if you don't want to pass a token in the URL as above.
On a Linux based system you can use the cURL utility to quickly create a request, an example command is as follows (using the Free tier as example) curl https://api.ipdon.com/8.8.8.8 using the cURL utility or wget https://api.ipdon.com/8.8.8.8 using standard linux wget.
The API provides several ways to customize the response to suit your needs
To make the response easily readable, results are grouped by default according to the type of data (i.e. network, location, domain, abuse) You can turn this off and return a default flat list by specifying the ?skipRestructure=1 parameter
The hostname is by default omitted in the response for performance reasons. You can turn on automatic hostname resolution by passing the variable ?includeHostname=1 into the request URL.
All paid plans include a very handy overview of domain names hosted per specified IP. If this is not desired, for example to minimize response size - you can turn this off by passing the ?skipDomains=1 variable into the request
Flag related country data is also sent in response. Should you want to exclude this you can pass the ?includeFlag=0 variable into the request to remove this from the response.
The API provides a facility to send you a static map image in response to your request as SVG (vector image). The URL to this image is part of each response in the location/map_url variable. If you want to turn this behavior off you can pass the ?includeMap=0 variable to the request.
In general, you can retrieve the static map of an IP address like so https://api.ipdon.com/<ip address>/map.svg?token=<API token> In addition, you can specify the width or height of the returned image by passing also the ?width=<number> and ?height=<number> attributes. The size of the marker can be adjusted using ?markerSize=<number>. Setting size to 0 will hide the marker
Example, map of 3.129.45.92:
