Global Search APIs

Global Search APIs allow security professionals to run advanced searches across the FullHunt database with a wide range of filters. Search for products within a country, a CVE across an industry, or all exposed services for a specific organization.

info

This API is available for enterprise users only.

Global Search

Run advanced searches across the FullHunt database with powerful filtering capabilities.

HTTP Request

POST https://fullhunt.io/api/v1/global/search

Example Request

curl "https://fullhunt.io/api/v1/global/search" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx" \
  -d '{"country": "GB", "product": "Citrix-NetScaler"}'

Example Response

{
  "query": {
    "country_code": "GB",
    "products": "Citrix-NetScaler"
  },
  "results": [
    {
      "host": "vpn.example.co.uk",
      "domain": "example.co.uk",
      "ip_address": "203.0.113.42",
      "http_status_code": 200,
      "http_title": "Citrix Gateway",
      "is_live": true,
      "is_resolvable": true,
      "is_cloud": false,
      "is_cdn": false,
      "categories": ["Web-Servers"],
      "dns": {
        "a": ["203.0.113.42"],
        "aaaa": [],
        "cname": [],
        "mx": [],
        "ns": [],
        "ptr": [],
        "txt": []
      },
      "cert_object": {
        "subject_common_name": "vpn.example.co.uk",
        "issuer_common_name": "DigiCert Global G2 TLS RSA SHA256 2020 CA1",
        "issuer_organization": "DigiCert Inc",
        "not_before": "01-01-2025 00:00:00",
        "not_after": "01-01-2026 23:59:59",
        "signature_algorithm": "SHA256-RSA",
        "dns_names": ["vpn.example.co.uk"],
        "is_valid_hostname": true
      },
      "cloud": {
        "provider": "",
        "region": ""
      },
      "ip_metadata": {
        "asn": 2856,
        "isp": "BT",
        "organization": "BT Public Internet Service",
        "country_code": "GB",
        "country_name": "United Kingdom",
        "city_name": "London",
        "region": "England"
      },
      "network_ports": [443],
      "network_services": [
        {
          "port": 443,
          "type": "tcp",
          "service": ["https"],
          "httpstatuscode": 200,
          "httptitle": "Citrix Gateway",
          "category": ["Web-Servers"],
          "product": [
            {
              "name": "Citrix-NetScaler",
              "version": "",
              "cpe23": [],
              "maincpe": ""
            }
          ],
          "web": ["HSTS"]
        }
      ],
      "products": [{"name": "Citrix-NetScaler", "version": ""}],
      "tags": ["https", "citrix-netscaler", "web-servers"],
      "web": ["HSTS"]
    }
    // ... additional results omitted
  ],
  "total_pages": 1000000,
  "total_query_results": 10000000
}

Response Fields

Field	Type	Description
query	object	The search filters that were applied
results	array	List of matching host objects (same schema as Host APIs)
total_pages	integer	Total number of result pages
total_query_results	integer	Total number of matching hosts

Each object in results follows the same structure documented in the Host APIs response fields.

---

Request Filters

FullHunt Global Search supports the following filters:

Filter	Type	Description
country	string	ISO country code (e.g., US, GB, FR)
product	string	Product name (e.g., Citrix-NetScaler, Apache, nginx)
organization	string	Organization name
asn	integer	Autonomous System Number
port	integer	Specific port number
tags	array	Service tags
technology	string	Web technology
cloud_provider	string	Cloud provider name
cdn	string	CDN provider name

Filters can be combined in a single request for precise targeting.

---

Example Use Cases

Find Citrix NetScaler instances in the UK

curl "https://fullhunt.io/api/v1/global/search" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx" \
  -d '{"country": "GB", "product": "Citrix-NetScaler"}'

Find Apache servers in a specific ASN

curl "https://fullhunt.io/api/v1/global/search" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx" \
  -d '{"asn": 15169, "product": "Apache"}'

Find hosts with specific tags

curl "https://fullhunt.io/api/v1/global/search" \
  -H "X-API-KEY: xxxx-xxxx-xxxx-xxxxxx" \
  -d '{"tags": ["https", "web-servers"]}'