Get a Saved Search

GET https://www.virustotal.com/api/v3/saved_searches/{id}

This endpoint returns a Saved Search object.

Examples

Get only the name, description and tags of the saved search 0a49acd622a44982b1986984ba31c15b.

Python

import requests

object_id = "0a49acd622a44982b1986984ba31c15b"
attributes = "name,description,tags"

url = f"https://www.virustotal.com/api/v3/saved_searches/{object_id}?attributes={attributes}"

headers = {"accept": "application/json","x-apikey": <api-key>}

response = requests.get(url, headers=headers)

Retrieve the saved search with ID 0a49acd622a44982b1986984ba31c15b, including its owner and all editors.

Python

import requests

object_id = "0a49acd622a44982b1986984ba31c15b"
relationships = "owner,editors"

url = f"https://www.virustotal.com/api/v3/saved_searches/{object_id}?relationships={relationships}"

headers = {"accept": "application/json","x-apikey": <api-key>}

response = requests.get(url, headers=headers)