pricing background

IP Security Database Documentation

IP Security Snapshot

Download the IP Security snapshot data for a specific day by using the date parameter. The response is a gzipped CSV file containing IP security details, such as whether the IP is flagged as spam, associated with Tor, a cloud provider, a bot, anonymous, and more. The date of the latest prepared snapshot can be retrieved via the Status API endpoint.

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.
  • date
    Use the date parameter in yyyy-MM-dd (2026-01-26) format to get the snapshot of that day.

Request

shellnodejsjavapythonphprubyjscsharpgocswiftjquery
SHELL
Loading request...

Response

Loading response...

Status Codes

Success Codes
  • 200  Request is processed successfully.
Failure Codes
  • 400  Please pass apiKey param value.
  • 400  Please provide the date parameter
  • 400  Invalid date parameter
  • 401  Api record not found.
  • 401  Provided API key is inactive.
  • 401  Please buy database subscription.
  • 401  Your database subscription plan is inactive.
  • 401  You cannot download file.
  • 401  You have exceeded the download limit of 20000.
  • 401  Suspicious Activity.
  • 404  File is not available of this date.
  • 413  Please upgrade your plans.

IP Security Snapshot Status

Use the endpoint to get the status of the latest IP Security snapshot. The JSON output contains the snapshot name, creation date, and expected deletion date.

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 pass apiKey param value.
  • 401  Api record not found.
  • 401  Provided API key is inactive.
  • 401  You cannot download file.
  • 401  Your account is deactivated.
  • 401  You have exceeded the download limit of 20000.
  • 401  Suspicious Activity.
  • 413  Please upgrade your plans.