Search History

Description

This endpoint is used to provide the client a list of the searches available in the user history, it will not return the actual search results, simply an index of them.

It is available at the following URL.

https://api.intelsentry.io/v1/history

Input Params

None.

HTTP Methods

• GET: Used to retrieve the list of past searches.

Example Request

GET https://api.intelsentry.io/v1/history
Authorization: Bearer <token>

curl -X GET -H "Authorization: Bearer <token>" https://api.intelsentry.io/v1/history

curl.exe -X GET -H "Authorization: Bearer <token>" https://api.intelsentry.io/v1/history

$headers = @{}
$headers.Add("Authorization","Bearer <token>")
Invoke-WebRequest -Headers $headers -Method GET https://api.intelsentry.io/v1/history | select -ExpandProperty Content

import requests
 
headers = {"Authorization": "Bearer <token>"}
response = requests.get("https://api.intelsentry.io/v1/history", headers=headers)
print(response.text)

Example Response

HTTP/1.1 200
Content-Type: application/json
 
{
    "status": 200,
    "results": [
        {
            "id": "c16da701-b9ba-4046-82a8-01208ba384dd",
            "query": "example",
            "results_count": 10000,
            "date_searched": 1742685447093
        },
        <...>
        {
            "id": "7fe73e65-19ba-40c1-b83a-bf425976ee21",
            "query": "@example.com",
            "results_count": 4000,
            "date_searched": 1743288450046
        }
    ],
    "total_results": 43
}

Note that the most important key is the id inside the list, since it will later be used in /v1/history/{search-id}. Moreover, the date_searched value represents the Unix UTC Timestamp in milliseconds of the time that the search was executed. Finally, the total_results key corresponds to the length of the list.

Status Codes