Pre-Search Count

Description

This endpoint is used to extract the maximum results size of a given query, as well as its cost. It is useful when used before the search in order to prevent overspending search tokens, since you will obtain the necessary information to execute a paged query. Note that this endpoint does not cost any search tokens to use.

It is available at the following URL.


https://api.intelsentry.io/v1/search/count

Input Params

query: Mandatory JSON body parameter used to indicate the asset that will be searched in the credentials leak database. May be a domain, username, IP, URL, or email. Note that, in order to comply with ethical guidelines, sensitive TLDs such as .gov, .mil, and .int are banned.

HTTP Methods

POST: Used to execute the count for a given search query and obtain the results.

Example Request

Plain


POST https://api.intelsentry.io/v1/search/count
Authorization: Bearer <token>
Content-Type: application/json
 
{
    "query": "example.com"
}

Shell


curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"query":"example.com"}' https://api.intelsentry.io/v1/search/count

cmd


curl.exe -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d "{\"query\":\"test.com\"}" https://api.intelsentry.io/v1/search/count

PowerShell


$headers = @{}
$headers.Add("Authorization","Bearer <token>")
$headers.Add("Content-Type","application/json")
$body = @{}
$body.Add("query", "example.com")
$bodyJson = $body | ConvertTo-Json
Invoke-WebRequest -Headers $headers -Method POST -Method POST -Body $bodyJson https://api.intelsentry.io/v1/search/count | select -ExpandProperty Content

Python


import requests
 
headers = {"Authorization": "Bearer <token>", "Content-Type": "application/json"}
query = {"query": "example.com"}
response = requests.post("https://api.intelsentry.io/v1/search/count", headers=headers, json=query)
print(response.text)

Example Response


HTTP/1.1 200
Content-Type: application/json
 
{
    "status": 200,
    "count": 30797,
    "cost": 16,
    "searches_left": 1500
}

With this, you will obtain the necessary information to know whether you can afford and want to execute a given query or prefer a paged version to get partial data.

Status Codes

Status Code	Description
200	The count was correctly executed and results were returned
400	The request was not correct e.g. query parameter was not provided
403	The user does not have access to that data at that time e.g. attempted a banned query
503	The backend services are temporarily down at that time