From 58bad63007cd4364f04fc2c5bc971ff576bced25 Mon Sep 17 00:00:00 2001 From: docs-update-bot Date: Wed, 30 Sep 2026 09:20:20 +0000 Subject: [PATCH] Docs | Update CatchAll API docs for v1.9.0 Co-Authored-By: Claude Opus 5.5 --- .../api-reference/catch-all-api.yml | 2 +- web-search-api/concepts/event-monitors.mdx | 6 +++ web-search-api/get-started/changelog.mdx | 37 +++++++++++++++++++ .../how-to/troubleshoot-event-monitors.mdx | 19 ++++++++++ 4 files changed, 63 insertions(+), 1 deletion(-) diff --git a/web-search-api/api-reference/catch-all-api.yml b/web-search-api/api-reference/catch-all-api.yml index 272d3fb..a033f7f 100644 --- a/web-search-api/api-reference/catch-all-api.yml +++ b/web-search-api/api-reference/catch-all-api.yml @@ -1,7 +1,7 @@ openapi: 3.1.0 info: title: NewsCatcher CatchAll API - version: 1.8.2 + version: 1.9.0 description: | CatchAll is a web search API that generates unique datasets that don't exist anywhere else on the web. Built on NewsCatcher's proprietary real-world event index, it delivers state-of-the-art recall—finding all relevant events, not just top results. diff --git a/web-search-api/concepts/event-monitors.mdx b/web-search-api/concepts/event-monitors.mdx index a0ea431..e19cddd 100644 --- a/web-search-api/concepts/event-monitors.mdx +++ b/web-search-api/concepts/event-monitors.mdx @@ -602,6 +602,12 @@ client.monitors().updateMonitor( Resume execution of a disabled event monitor: + + If your account runs out of credits, event monitors are disabled + automatically, and you get an email (at most one per day). After adding + credits, enable the event monitor again to resume scheduled runs. + + ```bash cURL diff --git a/web-search-api/get-started/changelog.mdx b/web-search-api/get-started/changelog.mdx index 5acad01..b04ab78 100644 --- a/web-search-api/get-started/changelog.mdx +++ b/web-search-api/get-started/changelog.mdx @@ -5,6 +5,43 @@ description: Track updates, improvements, and fixes to the CatchAll API. rss: true --- + +## Paused event monitor alerts and better watchlist recall + +A quality release with no request or response changes. You now get an email +when an event monitor is paused for lack of credits. Watchlist-connected jobs +also match more articles, and validation no longer drops records on criteria it +never checked. Existing jobs and event monitors pick up these changes +automatically. + +### Email alert when an event monitor is paused + +When an account runs out of credits, scheduled event monitors are disabled +automatically. You now get an email when this happens, so a monitor doesn't stop +without you knowing. Emails are limited to one per day, so an account that runs +out of credits doesn't get a flood of notifications. + +After adding credits, resume the monitor with +[`POST /catchAll/monitors/{monitor_id}/enable`](/web-search-api/api-reference/event-monitors/enable-monitor). +See +[Troubleshoot event monitors](/web-search-api/how-to/troubleshoot-event-monitors#event-monitor-stopped-running). + +### Better recall for watchlist-connected jobs + +Jobs submitted with `connected_dataset_ids` now match articles against the same +fields as the Search API. Before, some watchlist queries missed articles because +English word-stem matching was skipped. Source rank filters are now applied to +watchlist searches too, except when a source group filter is also set. + +### Fixes and improvements + +- Fewer records dropped during validation. Every validator criterion now gets an + explicit verdict. Before, a criterion that the model skipped counted as failed, + which could discard records on criteria that were never checked. +- Fixed model fallback during enrichment. When the primary model is unavailable, + enrichment now falls back to the backup model instead of failing. + + ## Update event monitor schedules diff --git a/web-search-api/how-to/troubleshoot-event-monitors.mdx b/web-search-api/how-to/troubleshoot-event-monitors.mdx index 33b4847..0bc4813 100644 --- a/web-search-api/how-to/troubleshoot-event-monitors.mdx +++ b/web-search-api/how-to/troubleshoot-event-monitors.mdx @@ -172,6 +172,25 @@ For webhook implementation guidance including error handling and retry logic, se --- +## Event monitor stopped running + +**Symptom**: Scheduled runs stop, and you receive an email saying the event +monitor was paused. + +**Cause**: The account ran out of credits, so the event monitor was disabled +automatically. The notification email is sent at most once per day. + +**Resolution**: + +1. Add credits to your account or upgrade your plan. +2. Re-enable the event monitor with + [`POST /catchAll/monitors/{monitor_id}/enable`](/web-search-api/api-reference/event-monitors/enable-monitor). + See [Enable event monitor](/web-search-api/concepts/event-monitors#enable-event-monitor). +3. Check the [status history](/web-search-api/concepts/event-monitors#get-status-history) + to confirm the event monitor is active again. + +--- + ## Need more help? If you encounter issues not covered in this guide: