Saving and re-running searches

Saved searches turn a one-off search into a repeatable lead source.

1. Run your search with the filters you want and confirm the results look right.
2. Use save_search with a descriptive name, a search_type (people, companies, or posts), and the same parameters object. You can also store a pasted LinkedIn or Sales Navigator search URL instead of structured filters.
3. Later, use run_saved_search with the search_id to execute it live again.
4. Use list_saved_searches to see everything you've saved with the IDs, and delete_saved_search to prune stale ones.

Two options make run_saved_search powerful for ongoing prospecting:

• from_last_cursor: true resumes pagination where the previous run stopped, so you can walk deep into a large result set across multiple sessions.
• new_results_only: true returns only people who are new since the last run. This is the backbone of an always-on lead discovery loop: same targeting, only fresh faces.

There is also a cached path: get_search_results returns stored results for a saved search, populated nightly. Pass only_new: true to see just the results added since your last check (they get marked as seen). An empty array right after saving is normal, it means the nightly population hasn't run yet.

Saved searches use stable LinkedIn IDs, so location and industry names are resolved once at save time and won't drift later.

Pro tip: name searches after the ICP they represent ('VP Engineering Netherlands', 'Seed-stage fintech founders') and check them each morning with new_results_only. Ten minutes of review gives you a daily feed of fresh, pre-qualified prospects.