Skip to main content
A saved search stores targeting: the same filters as person_search or company_search. Running it is always a free preview and uses your daily preview allowance. It never fetches paid records. How alerts work:
  • Alerts are off unless you turn them on. When on, you get a daily email at your account address.
  • The first successful run sets a baseline. Later runs report records newly seen in the free sample, not every new match in the database.
You can have up to 20 saved searches.

saved_search_create

string
required
Search name.
string
required
person or company.
object
required
The search filters to save. Paid controls (preview, limit, cursor) and full exclusion lists are not saved. Up to 10 exclude_company_domains.
boolean
default:"false"
true for the daily email.

saved_search_run

Run a saved search as a free preview.
string
required
The saved search.

saved_search_update

Rename a search, or turn its alerts on or off. The agent asks before turning alerts on.
string
required
The saved search.
string
New name.
boolean
true or false.

saved_search_list

List your saved searches and their alert status. No parameters.

saved_search_delete

Delete a saved search and stop its alerts. The agent asks you to confirm first.
string
required
The saved search.