Skip to content

Using the search API

This guide walks you through the process of using your generated API key to preform a basic query to honeypotdb using Insomina.

Setup

Here, I will use Insomnia, but feel free to use other tools such as Postman or cURL.

Creating a HTTP Request

Create a HTTP request on your software of choice.

Insomina HTTP Request Creation

Setting up authentication

Navigate to your Auth configuration pannel

Insomina Auth Navigation

You will need to configure a new authentication header, with the key "X-API-KEY" and populate the value with your API Key. You may also use a JWT Authentication token. For more infomration on Authentication, please refer to Authentication Docs

Insomina Auth Setup

Map the URL and Body

We now need to populate the body of the request. This is where we can configure our query parameters.

Insomina Body Configuration

You can see an example body below, this query will return all ssh crowie pots deployed between July 8th and August 8th. For more details, see Query Docs

Insomina URL Configuration

Switch Method POST

Switch the HTTP method to Post.

Insomina Method Configuration

Response

We are now ready to send the request, simply press send.

Insomina Query Response

Here we can see results from the API.

Next Steps

For more details, please refer to our API Documentation

That's it, you're ready to start querying our threat intelligence. Take a look at the guides below as suggestions on what to do next: