harmonic_get_saved_search_net_new_results
Retrieve only new matches from a saved search since your last check to monitor incremental deal flow changes, such as companies meeting investment criteria.
Instructions
Get only NEW results from a saved search since your last check. This is the incremental/delta endpoint for monitoring deal flow.
PREREQUISITE: You must subscribe to the saved search via Harmonic web UI first. Returns 404 if not subscribed.
What "net new" means: Returns companies/people that have NEWLY matched your search criteria since you subscribed (or since new_results_since date). For example, if your search looks for companies with >100 headcount, this returns companies that recently grew past 100.
Input:
search_id: The saved search ID (get from harmonic_list_saved_searches)
size: Number of results (default: 3, max: 5)
cursor: Pagination cursor for more results
new_results_since: Optional UTC datetime (e.g., 2024-09-21T00:00:00Z)
Response sizes: ~27KB per result (same as regular results)
Workflow:
Call this tool to get new matches
Process the results
Call harmonic_clear_saved_search_net_new to mark as "seen"
Repeat on your monitoring schedule
Use cases:
Daily deal flow monitoring for investors
Trigger deep research agents on new matches
Alert on companies meeting investment criteria
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search_id | Yes | Saved search ID or URN | |
| size | No | Number of results to return (default: 3, max: 5). Each result is ~27KB. | |
| cursor | No | Pagination cursor from previous response | |
| new_results_since | No | UTC datetime (e.g., 2024-09-21T00:00:00Z) to filter results. Defaults to subscription date. | |
| response_format | No | Output format: "json" or "markdown" | json |