Advanced APIs
Monitors
Watch pages, domains, pricing, and searches on a schedule, and get notified when something changes.
Overview
A monitor runs on a schedule (hourly, daily, or weekly) and detects changes since its last run. You can also trigger a run on demand. Optionally deliver results to a webhook.
Where monitors are managed
Create, list, update, and delete monitors from your dashboard. Programmatic API keys can trigger a run for a monitor you already own with
POST /monitors/{id}/run, but creating and listing monitors is done from the dashboard.Monitor types
page_change_monitor: detect when a specific page changes.search_monitor: watch a search query for new results.domain_monitor: watch a domain for new or changed pages.pricing_monitor: extract and track structured pricing from a page.
Creating monitors
Monitors are configured with these fields:
| Field | Type | Default | Description |
|---|---|---|---|
namerequired | string | - | Human-readable name (1 to 200 characters). |
typerequired | string | - | One of the monitor types above. |
targetrequired | string | - | A URL or a search query, depending on type. |
frequency | string | daily | One of hourly, daily, weekly. |
include_summary | bool | false | Include a short summary of what changed. |
webhook_url | string | null | POST results here when a change is detected. |
Running a monitor
Trigger a run for a monitor you own. This is asynchronous and returns a job_id to poll.
POST
/monitors/{id}/runRequest
curl https://api.ohsee.tech/monitors/42/run \
-H "Authorization: Bearer ohsee-<your-key>"Credits
Creating a monitor is free. Each run costs credits based on the work it does: a search monitor is priced like a search, a pricing monitor like a structured extraction, and a domain monitor like a map. When no change is detected, a run costs 1 credit. If your balance is too low, the monitor pauses until you top up.