Skip to content
/Saved Searches

Saved Searches

urlscan Pro - Saved Searches are rules that are executed inline against new incoming scans and hostnames.

Operations

Saved Searches

Request

Get a list of Saved Searches for the current user.

Security
apikeyAuth(Required scopes: readwrite)
GET
/api/v1/user/searches/
curl -i -X GET \
  https://urlscan.io/api/v1/user/searches/ \
  -H 'api-key: YOUR_API_KEY_HERE'

Responses

Successful response

Bodyapplication/json
searchesArray of objects(savedSearchResponse)
Example:
[
  {
    "_id": "{{searchId}}",
    "datasource": "scans",
    "query": "page.domain:urlscan.io",
    "name": "Testsearch",
    "description": "urlscan documentation example saved search.",
    "longDescription": "Example saved search created from urlscan documentation",
    "tlp": "red",
    "userTags": [ … ],
    "permissions": [ … ]
  }
]
Response
{
  "searches": [
    { … }
  ]
}