Get daily stats grouped by vhash

GET https://www.virustotal.com/api/v3/stats/vhash_clusters

🚧

Special privileges required

This endpoint is only available for users with premium privileges.

This endpoint returns statistics from a given day, grouping scanned files by their vhash. The endpoint returns a list of Cluster objects, sorted by their size in descending order.

In addition, the response's meta includes:

• count: <integer> total number of clusters.
• num_top200: <integer> total number of files in the top 200 clusters. Clusters are sorted by size.
• candidates: <integer> number of files having feature hash.

vhash_clusters

{
  "meta": {
    "count": <int>,
    "num_top200": <int>,
    "candidates": <int>
  },
  "data": [
    <CLUSTER_OBJECT>,...
  ]
}

Example

{
  "meta": {
    "count": 222624,
    "num_top200": 521048,
    "candidates": 1035632
  },
  "data": [
    {
      "attributes": {
        "files": 82665,
        "discriminator": "02503f7f5d51z13z11z2015z17z1011z1fz",
        "vector": "vhash",
        "mean_positives": 45,
        "name": "aapw/dropped [0000]"
      },
      "type": "cluster",
      "id": "vhash02503f7f5d51z13z11z2015z17z1011z1fz"
    }
  ]
}