Ransomware Statistics API

The Ransomware Statistics API provides aggregated statistics on ransomware attacks, allowing you to analyze trends by country, group, and industry sector.

Get Statistics by Country

GET/api/v2/stats/countries

Retrieve statistics on the number of ransomware attacks detected against different countries.

Parameters

Name	Type	Required	Description
countries	string	No	Country list following ISO 3166-1 alpha-2 codes (e.g., UK, FR, ES)
gte	string	No	Start date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)
lte	string	No	End date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)

Examples

Shell

curl "https://api.vysion.ai/api/v2/stats/countries?countries=ES,FR" \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Python

from vysion import client

c = client.Client(api_key=API_KEY)

countries = "ES,FR"
result = c.ransomware_countries_stats(countries)

print(result)

Response

{
  "data": {
    "total": 2,
    "hits": [
      {
        "key": "ES",
        "doc_count": 45
      },
      {
        "key": "FR",
        "doc_count": 32
      }
    ]
  },
  "error": null
}

Get Statistics by Group

GET/api/v2/stats/groups

Retrieve statistics on the number of attacks performed by different ransomware groups.

Parameters

Name	Type	Required	Description
countries	string	No	Country list following ISO 3166-1 alpha-2 codes (e.g., UK, FR, ES)
gte	string	No	Start date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)
lte	string	No	End date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)

Examples

Shell

curl "https://api.vysion.ai/api/v2/stats/groups" \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Python

from vysion import client

c = client.Client(api_key=API_KEY)

result = c.ransomware_groups_stats()

print(result)

Response

{
  "data": {
    "total": 3,
    "hits": [
      {
        "key": "lockbit",
        "doc_count": 156
      },
      {
        "key": "alphv",
        "doc_count": 89
      },
      {
        "key": "play",
        "doc_count": 67
      }
    ]
  },
  "error": null
}

Get Statistics by Sector

GET/api/v2/stats/sector

Retrieve statistics on the number of attacks based on the victim’s industry sector, using NAICS (North American Industry Classification System) codes.

Parameters

Name	Type	Required	Description
countries	string	No	Country list following ISO 3166-1 alpha-2 codes (e.g., UK, FR, ES)
gte	string	No	Start date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)
lte	string	No	End date (Unix timestamp, YYYY-MM-DD, or YYYY-MM-DDThh:mm:ss)

Examples

Shell

curl "https://api.vysion.ai/api/v2/stats/sector" \
  --header 'Accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Python

from vysion import client

c = client.Client(api_key=API_KEY)

sector = "31"
result = c.ransomware_groups_sector(sector)

print(result)

Response

{
  "data": {
    "total": 4,
    "hits": [
      {
        "key": "54",
        "doc_count": 78
      },
      {
        "key": "31-33",
        "doc_count": 65
      },
      {
        "key": "62",
        "doc_count": 43
      },
      {
        "key": "52",
        "doc_count": 32
      }
    ]
  },
  "error": null
}

Response Schema

All statistics endpoints return the same response structure:

Statistics Response

Field	Type	Description
data.total	integer	Total number of statistic buckets
data.hits	array	Array of statistic objects
data.hits[].key	string	The category key (country code, group name, or NAICS code)
data.hits[].doc_count	integer	Number of attacks for this category
error	object	Error information (null if successful)

Common NAICS Codes

Here are some common NAICS sector codes you might encounter:

Code	Industry
11	Agriculture, Forestry, Fishing and Hunting
21	Mining, Quarrying, and Oil and Gas Extraction
22	Utilities
23	Construction
31-33	Manufacturing
42	Wholesale Trade
44-45	Retail Trade
48-49	Transportation and Warehousing
51	Information
52	Finance and Insurance
53	Real Estate and Rental and Leasing
54	Professional, Scientific, and Technical Services
55	Management of Companies and Enterprises
56	Administrative and Support and Waste Management
61	Educational Services
62	Health Care and Social Assistance
71	Arts, Entertainment, and Recreation
72	Accommodation and Food Services
81	Other Services (except Public Administration)
92	Public Administration

Error Responses

Statistics endpoints may return these error codes:

Status	Error Code	Description
401	Unauthorized	Invalid or missing API key
422	Unprocessable Entity	Invalid parameters
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server error