Introducing Seltz Monitor

You can now track up to 1,000 searches continuously with a single Seltz Monitor, checking as often as once an hour, and get notified the moment something new shows up instead of re-running the same search yourself.

Monitor is available today as a new API endpoint alongside Search and Answer.

A request to the new Monitor endpoint creates a persistent search that runs on the cadence you choose, and returns only new, deduplicated results. You can get push results through a webhook, or poll them by paging through records whenever you check in.

Like Search and Answer, Monitor runs against the same up-to-date owned index and scopes. The difference is what happens after the first run: instead of returning what matches right now and forgetting about it, a monitor keeps checking on your behalf and remembers what it's already shown you.

How it works

You can set up a monitor in one call:

• Create a monitor with one or more search queries and a cadence, from every hour up to once every 366 days.

  
  

• Optionally attach a webhook so you're notified the moment a run finds something new, instead of checking back yourself.

Creating a monitor

The following Python snippet creates a monitor that tracks acquisition news for two companies, checking every six hours.

from seltz import Seltz

client = Seltz()

response = client.monitor.create(
    "watchlist-ma-deals",
    cadence="6h",
    search_requests=["Apple acquisition merger", "Amazon acquisition merger"], 
        # Supports up to 1,000 requests
    webhook={
        "url": "https://example.com/seltz/monitors",
        "events": ["run.completed"],
    },
)
print(response.monitor.monitor_id)

from seltz import Seltz

client = Seltz()

response = client.monitor.create(
    "watchlist-ma-deals",
    cadence="6h",
    search_requests=["Apple acquisition merger", "Amazon acquisition merger"], 
        # Supports up to 1,000 requests
    webhook={
        "url": "https://example.com/seltz/monitors",
        "events": ["run.completed"],
    },
)
print(response.monitor.monitor_id)

from seltz import Seltz

client = Seltz()

response = client.monitor.create(
    "watchlist-ma-deals",
    cadence="6h",
    search_requests=["Apple acquisition merger", "Amazon acquisition merger"], 
        # Supports up to 1,000 requests
    webhook={
        "url": "https://example.com/seltz/monitors",
        "events": ["run.completed"],
    },
)
print(response.monitor.monitor_id)

The monitor runs immediately, then again every six hours. Each run only reports what's new since the last one.

Reading what a monitor finds

Once a monitor has run, you can read its results with list_records, whether or not you're using a webhook:

records = client.monitor.list_records(response.monitor.monitor_id, limit=10)

for record in records.records:
    print(record.search_result.document.url)

records = client.monitor.list_records(response.monitor.monitor_id, limit=10)

for record in records.records:
    print(record.search_result.document.url)

records = client.monitor.list_records(response.monitor.monitor_id, limit=10)

for record in records.records:
    print(record.search_result.document.url)

The sample above returns documents like the following:

If you'd rather not poll, the same run that produced these records also triggers your webhook, with the run's ID included in the payload, so you can fetch exactly the new records for that run.

Use cases for Monitor:

• Deal and market intelligence. Track a list of companies for acquisition or funding news without standing up a monitor for each one. A single call to the /monitors endpoint can set up monitoring for up to 1,000 queries at once.

• Sales and account teams. Get notified when a prospect or existing account shows up in the news, so outreach can reference something that happened this week instead of something from a training cutoff.

• Sentiment analysis. Track brand sentiment by setting up recurring queries for your company or product name, allowing you to automatically aggregate and analyze new mentions in news or social sources to gauge public perception over time.

Try Seltz Monitor today

Seltz Monitor is available to use. Grab an API key at console.seltz.ai/api-keys and read the Monitor quickstart and API reference to get started.

Ciao, The Seltz Team