Bulk Lookup Method
This method is used to retrieve the information of multiple IP Addresses.
Option | Type | Description |
---|---|---|
ips * | Array | The IP Addresses you want to lookup. |
params | Array | Specifies the modules you want to retrieve as visitor information.
It's an Array of consist some Strings as it's items.
Accepts: location , security , timezone , currency and/or device .
Default: [] |
format | String | You can use this option to specify the API output format.
Accepts: JSON , XML , CSV or Newline .
Default: JSON |
lang | String | Specifies the API output language.
Accepts: EN , AR , DE , FR , ES , JA , JA , ZH or RU .
Default: EN |
mode | String | You can use this option for using the Development Environment of the API, read more.
Accepts: live or test .
Default: live |
Parameters with the (*) are required.
Basic example of using this method:
await BulkLookup({
key: 'your-api-key',
ips: ['1.1.1.1', '2.2.2.2']
})
.then(res => {
console.log(res);
})
.catch(error => {
console.log(error);
});
Description:
This method accepts one parameter of type
Object
. The Object
contains the options you want to specify for this method. Let's dive into this:Let's say that we want to retrieve the location information of the IP Addresses and also the timezone and security threats information. So the code will be like this:
await BulkLookup({
key: 'your-api-key',
ips: ['1.1.1.1', '2.2.2.2'],
params: ['timezone', 'security']
})
.then(res => {
console.log(res);
})
.catch(error => {
console.log(error);
});
Beside this, we can inform the module to return the response as
XML
:await BulkLookup({
key: 'your-api-key',
ips: ['1.1.1.1', '2.2.2.2'],
params: ['timezone', 'security'],
format: 'XML'
})
.then(res => {
console.log(res);
})
.catch(error => {
console.log(error);
});
And so on...
The
.then()
will return the response if it's successfully fetched and the .catch()
will return the error if something goes wrong.If the request completed successfully, so the
res
variable of .then()
returns the data in the format you specified. And we can read the data like this:await BulkLookup({
key: 'your-api-key',
ips: ['1.1.1.1', '2.2.2.2'],
params: ['timezone', 'security']
})
.then(res => {
console.log(res?.data);
})
.catch(error => {
console.log(error);
});
Last modified 1mo ago