Get a Saved Search

This endpoint returns a Saved Search object.

Examples

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

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.

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)
Path Params
string
required

Saved Search's ID.

Query Params
string

A comma-separated list of the saved search attributes to be returned. (All attributes are returned by default.)

string

Provides additional information about the saved search as relationships

Headers
string
required

Your API Key.

Responses

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