Pro plan & above

SightStatus API

Programmatic screenshot capture and monitor history for QA pipelines, AI agents, and internal tooling.

Start your free trial to explore the dashboard, then upgrade to Pro for API access.

Authentication

Pass your API key via header or query string. Keys start with ss_.

Authorization: Bearer ss_your_api_key_here

# or
?api_key=ss_your_api_key_here

Requests without a valid Pro+ key receive 403.

Capture a screenshot

Capture any URL on demand. Counts against your monthly capture quota.

GET https://sightstatus.com/api/v1/capture/?url=https://example.com&format=png&width=1920&height=1080
ParameterDescription
urlRequired. Page to capture.
formatpng, jpg, webp, or pdf (default: png)
width / heightViewport size (default 1920×1080)
mobiletrue — mobile viewport
fullpagetrue — full scrollable page
darkmodetrue — prefers dark color scheme
asynctrue — queue job, returns poll URL (202)
returnurl — JSON with image URL instead of binary

Poll async capture

GET https://sightstatus.com/api/v1/capture/{capture_id}/

Returns status: pending, completed, or failed. Completed responses include image_url.

List monitors

GET https://sightstatus.com/api/v1/monitors/

Monitor screenshot history

Returns today, yesterday, 7-day, and 30-day snapshots for a monitor UUID.

GET https://sightstatus.com/api/v1/monitors/{monitor_uuid}/history/

Error codes

401Missing or invalid API key
403Plan does not include API access
429Monthly capture limit reached

Try it free for 7 days

Business trial includes API access — no credit card required.

Start free trial