pricing background

Documentation

IP Geolocation Lookup

IP Geolocation API provides real-time and accurate geolocation, network, abuse, and security information for any IPv4 or IPv6 address.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Query Parameters

Required
  • apiKey
    You can obtain your API key from the billing dashboard.
  • ip
    The IP address for which you want to fetch geolocation data.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Provided name, service or IP address 'XXX.XXX.XXX.XXX' is not valid.
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  The requested IP does not not exists in our database.
  • 405  Invalid HTTP request method is being used for calling the endpoint. Only GET and POST methods are allowed. POST method for bulk endpoint and GET method for single lookup endpoint requests.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 423  The IP address you provided falls within bogon IP ranges, which are not routable on the public internet. Please make sure to use a valid, publicly accessible IP address for accurate results.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 499  The request or connection timeout you’ve set is too short, which is causing the server to close the connection before completing the response. Please increase the timeout duration to ensure successful communication with the server.
  • 500  Internal Server error occurred.
  • 502  Please provide ips in request body.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.
  • 505  You might be using an outdated HTTP version.

Bulk IP Geolocation Lookup

The Bulk IP Geolocation API delivers real‑time geolocation data, along with network and security details, for up to 100 IPv4 or IPv6 addresses in a single request.

Authorization

You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.

Query Parameters

Required
  • apiKey
    Get your API key from our billing dashboard.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please provide IPs in the request body..
  • 401  Provided API key is invalid.
  • 401  Provided API key is inactive.
  • 401  Please buy a subscription plan or add api credits, then use this api key.
  • 401  Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
  • 401  Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
  • 401  Your account is deactivated.
  • 401  You are blocked due to suspicious activity.
  • 404  The requested IP does not not exists in our database.
  • 405  Invalid HTTP request method is being used for calling the endpoint. Only GET and POST methods are allowed. POST method for bulk endpoint and GET method for single lookup endpoint requests.
  • 408  Unable to fetch whois data. Please try again.
  • 412  You have exceeded the limit of api plan requests and your subscription is canceled.
  • 413  The requested list size is [GREATER_THAN_100] which exceeds the maximum list size of 100.
  • 413  You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
  • 423  The IP address you provided falls within bogon IP ranges, which are not routable on the public internet. Please make sure to use a valid, publicly accessible IP address for accurate results.
  • 429  Please slow down. Your maximum request limit per minute is reached.
  • 499  The request or connection timeout you’ve set is too short, which is causing the server to close the connection before completing the response. Please increase the timeout duration to ensure successful communication with the server.
  • 500  Internal Server error occurred.
  • 502  Please provide ips in request body.
  • 503  Service is unavailable. Please try after some time.
  • 504  Request is timed-out.
  • 505  You might be using an outdated HTTP version.