Skip to main content
GET
A run is available as soon as Run a monitor now returns it. Read status to check its progress, changes for findings, and target_errors for Page targets that could not be read. Every run includes usage.searches, usage.fetched_urls, and an estimated usage.cost, with total_cost and currency (USD). Usage and cost are zero unless the run succeeds. See Monitor API pricing for rates. A failed run’s error has code and message; a skipped run has skip_reason and message. Use the typed code or reason rather than parsing message text. Each Page target error has type, url, code, and message. An error with code http_status also includes status_code; other codes distinguish blocked pages, missing content, timeouts, and fetch failures. Allow for new codes.

Read changes

  • Search results: changes[].type is search_result. A result can include a title, snippet, published_at, and last_updated_at; unavailable fields are omitted rather than set to null.
  • Page changes: changes[].type is page_change. The diff contains unified text, added and removed line counts, and a truncated flag. Line counts cover the full diff even when the unified text is truncated.
  • Change IDs: changes[].id stays the same wherever the same finding is reported. Use it to deduplicate findings across runs and webhooks, and skip change types you do not recognize.
Timestamps use RFC 3339 in UTC with whole seconds. A Search result’s last_updated_at is the source’s last-updated date, at calendar-day precision, not the exact time its content changed. published_at is its publication date; selecting updated freshness does not make URLs already reported by this monitor eligible again. finished_at is omitted until the run ends, and window is omitted while it is queued.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

monitor_id
string
required

Monitor identifier (mon_...)

run_id
string
required

Run identifier (run_...)

Response

The run

id
string
required

Opaque ID with the prefix run_

Maximum string length: 64
object
enum<string>
required
Available options:
monitor.run
monitor_id
string
required
trigger
enum<string>
required

What started the run. New triggers may be added; accept unknown values.

Available options:
schedule,
manual
status
enum<string>
required

queued is a manual run that has not started. skipped is a run that did not start, including a queued run cancelled by pausing the monitor. New statuses may be added; treat an unknown one as not finished.

Available options:
queued,
running,
succeeded,
failed,
skipped
counts
object
required
usage
object
required

Usage for the run. Only a succeeded run has nonzero usage. Search monitors report successful search calls in searches but are billed once per run; Page monitors report counted fetched_urls. The other counter is zero. Judging is included in the price.

changes
object[]
required

One finding the judge kept. New types may be added; skip changes with an unknown type.

target_errors
object[]
required
created_at
string<date-time>
required

RFC 3339 in UTC with whole seconds, for example 2026-11-12T09:00:41Z.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$
window
object

Omitted while the run is queued

error
object

Only on failed and skipped runs

finished_at
string<date-time>

Omitted until the run ends

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$