API Reference

Private Scan URL

post
https://www.virustotal.com/api/v3/private/urls

This returns an Analysis ID. The analysis can be retrieved by using the Analysis endpoint.

Analysis observations:

To get a more comprehensive analysis and gather different kinds of information beyond what a typical sandbox provides, you should use chrome_headless_linux as an additional or specific type of sandbox environment.

Form Data
string
required

URL to scan

string

User agent string.

string

Comma separated eg: chrome_headless_linux,cape_win,zenbox_windows possible values chrome_headless_linux, cape_win and zenbox_windows.

int32

Optional, number of days the report and URL are kept in VT (between 1 and 28). If not set it defaults to the group's retention policy preference (1 day by default).

string
enum

Optional, storage region where the URL will be stored. By default uses the group's private_scanning.storage_region preference. Allowed values are US, CA, EU, GB.

Allowed:
string
Defaults to cape_win

Select the sandbox desired for interactive use, possible values cape_win.

int32
Defaults to 60

Interaction timeout in seconds, minimum value: 60. (1 minute.) Max value: 1800: (30 minutes)

Headers
string
required

Your API key

Responses

Updated 6 months ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago