Skip to content

API reference

Python ⅔ library for the Vulners Database. It provides search, data retrieval, archive and vulnerability scanning API's for the integration purposes. With this library you can create powerful security tools and get access to the world largest security database.

API key

Guide with pictures

Please, register at Vulners website. Go to the personal menu by clicking at your name at the right top corner. Follow API KEYS tab. Generate API key with scope "api" and use it with the library.

Interaction with the Vulners REST api requires an API key. Basically, this version of the documentation provides general examples for rest APIs that can be used with any programming language. For example, you can implement your own Go sdk.

Python SDK

If you are going to use python, you can use Vulners python library. Python Library was tested on a python2 and python3. You can use pip for the installation pip install -U vulners. Package is also available with PyPI.

All the callable methods are using Vulners REST API. Automate your audit routines with Vulners. Mandatory code that is inserted at the beginning before each code example:

Query:

POST /api/v3/apiKey/valid/

Input data can be:

  • Query string
  • JSON

Query String example:

curl -XPOST 'https://vulners.com/api/v3/apiKey/valid/?keyID={API key}'

JSON example:

curl -XPOST --compressed https://vulners.com/api/v3/apiKey/valid -H 
'Content-Type: application/json' -d '{
    "keyID": "{API key}"
}'
import vulners

vulners_api = vulners.Vulners(api_key="YOUR_API_KEY_HERE")
{
    "result": "OK",
    "data": {
        "valid": true
        }
}
Back to top