These docs are for v2.0. Click to read the latest docs for v3.0.

Search for files

🚧

Private API

This endpoint is available in the Private API only.

In addition to retrieving information on a particular file, VirusTotal allows you search for files matching certain properties. For example, this functionality enables you to retrieve all those files marked by at least one antivirus vendor as Zbot, or all those files that have a size under 90KB and are detected by at least 10 antivirus solutions, or all those PDF files that have an invalid XREF section, etc.

This API is equivalent to VirusTotal Intelligence advanced searches. A very wide variety of search modifiers are available, including: file size, file type, first submission date to VirusTotal, last submission date to VirusTotal, number of positives, dynamic behavioural properties, binary content, submission file name, and a very long etcetera. The full list of search modifiers allowed for file search queries is documented at https://www.virustotal.com/intelligence/help/file-search/#search-modifiers.

On each request you will get at most 300 files matching the query. You can get the next 300 files by passing the offset received in the previous query as an argument to the next query. In those cases the query argument most be identical to the one passed to the previous request.

The returned files are sorted according to their submission date, in descending order.

{
 'response_code': 1,
 'offset': 'RmFsc2U6Q3ZrRkN1b0RDc1lEX...KdWVtcHpJeHA3TXk4M0h6OHpMbmN2X0FBRF',
 'hashes': [
   'c9bfeaf31115dccfe033f67c3b56453a5e434e2e39a2dcf76d80c05603ef9cda',
   '510c0c513b10ebec6ed5d577d8e4701950beb61bbc48f99a61c4780ba58e5fb9',
   '32aef41d79c9bca51c1aa63d1625abc721d2518e133b8667bcca9c4f0c4a60a6'
 ]
}
Language
Click Try It! to start a request and see the response here!