v1

latestOpenAPI 3.0.0Proprietary2026-07-244990150.4 KB
GNQL

GNQL V3 Stats

Get aggregate statistics for the top organizations, actors, tags, ASNs, countries, classifications, and operating systems of all the results of a given GNQL query.

get/v3/gnql/stats

Query parameters

querystring required

GNQL query string

countinteger

Number of top aggregates to grab

Response

Query successful.

querystring

The GNQL query string the requester queried

countinteger

The number of total results for the given GNQL query

adjusted_querystring

If the original query was adjusted due to plan limitations (for example, the requested data reach was reduced), this field contains the query that was actually executed. Empty when the original query was run unchanged.

Example response

{
  "query": "last_seen:2019-07-28 classification:malicious",
  "count": 50000,
  "adjusted_query": "last_seen:2019-07-28 classification:malicious last_seen:7d",
  "stats": {
    "classifications": [
      {
        "classification": "malicious",
        "count": 5000
      }
    ],
    "spoofable": [
      {
        "count": 5000
      }
    ],
    "organizations": [
      {
        "organization": "DigitalOcean, LLC",
        "count": 5000
      }
    ],
    "actors": [
      {
        "actor": "Shodan.io",
        "count": 5000
      }
    ],
    "countries": [
      {
        "country": "United States",
        "count": 5000
      }
    ],
    "source_countries": [
      {
        "country": "United States",
        "count": 5000
      }
    ],
    "destination_countries": [
      {
        "country": "United States",
        "count": 5000
      }
    ],
    "tags": [
      {
        "tag": "SSH Bruteforcer",
        "id": "4c076d9c-be48-4bd1-bec4-6005e06c0f89",
        "count": 5000
      }
    ],
    "operating_systems": [
      {
        "operating_system": "Windows 7/8",
        "count": 5000
      }
    ],
    "categories": [
      {
        "category": "education",
        "count": 5000
      }
    ],
    "asns": [
      {
        "asn": "AS4134",
        "count": 5000
      }
    ]
  }
}