Skip to main content
Beta: Monitor is currently in beta and enabled per account. Contact support to request access.
Monitor checks a webpage or web topic on a recurring schedule, keeps a history of each run, and shows what changed. You can review results in the TinyFish dashboard or send them to a webhook or email address.

Choose What to Monitor

Page Monitors run Fetch with ttl: 0 so they prefer fresh content. Topic Monitors can return 1-10 results per run and cannot run more often than every 30 minutes.

Create a Monitor

1

Open Monitor

Go to agent.tinyfish.ai/monitor and select New monitor.
2

Choose Page or Topic

For a Page Monitor, enter a public HTTP or HTTPS URL. For a Topic Monitor, enter the search query you want TinyFish to repeat.
3

Set the schedule

Choose how often the Monitor should run. Topic Monitors must be scheduled at least 30 minutes apart.
4

Choose delivery

Optionally add a webhook URL or turn on email updates. The account email is used as the default recipient, and you can replace it with another address.
You can also give the Monitor a name and describe the change that matters, such as The price drops below $500. When content changes, TinyFish evaluates the change against that purpose and displays the assessment with the run.
Creating a Monitor runs it immediately to capture a baseline. Future runs are compared with the latest completed result.

Understand Run Results

Each run has one of three outcomes: For Page Monitors, open a changed run to switch between the current result and a unified diff. For Topic Monitors, the run identifies the new result positions.

Delivery

Run now saves a new result in the dashboard but does not send webhook or email notifications. Notifications are sent by scheduled runs only.

Manage a Monitor

Open a Monitor from the dashboard to:
  • Run now without waiting for the next scheduled check
  • Pause future scheduled checks and resume them later
  • Edit its name, purpose, schedule, webhook, and email delivery settings
  • Delete the Monitor and its schedule
Pausing does not remove existing run history. Resuming recreates the schedule from the Monitor’s current configuration.

Use the API

The REST API supports creating, listing, reading, updating, pausing, resuming, deleting, and running Monitors.

Monitor API Reference

Create and manage Monitors over REST

Authentication

Set up an API key

Fetch API

Learn how Page content is extracted