On-Demand Scans

FullHunt continuously scans the internet to keep its database up-to-date. However, if you would like to trigger an on-demand scan for a specific target, you can do so using our API.

info

This API endpoint is available for enterprise accounts only.

Triggering an On-Demand Scan

You can submit a request to scan a specific target (domain, IP, or host).

HTTP Request GET https://fullhunt.io/api/v1/enterprise/on-demand-scans

Query Parameters

Parameter	Required	Type	Description
target	Yes	string	The target to scan (domain, IP address, or hostname)

Example Request

curl "https://fullhunt.io/api/v1/enterprise/on-demand-scans?target=kaspersky.com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Example Response

When a scan request is successfully submitted, you will receive the following response:

{
  "message": "On-demand scan request has been successfully sent to the queue for processing.",
  "status": 200
}

This indicates that your request is queued for processing. The results will be integrated into the FullHunt database once the scan is complete.

Supported Target Types

You can scan various types of targets:

Domain Names

Scan entire domains for subdomains, hosts, and infrastructure.

curl "https://fullhunt.io/api/v1/enterprise/on-demand-scans?target=example.com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

Specific Hosts

Scan individual hosts or subdomains.

curl "https://fullhunt.io/api/v1/enterprise/on-demand-scans?target=api.example.com" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

IP Addresses

Scan specific IP addresses for services and technologies.

curl "https://fullhunt.io/api/v1/enterprise/on-demand-scans?target=8.8.8.8" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"

IP Ranges

Scan entire IP ranges (CIDR notation).

curl "https://fullhunt.io/api/v1/enterprise/on-demand-scans?target=8.8.8.0/24" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx"