Test and verify
POST /v1/checks/*
Page Checks API
When you need one focused answer per URL — not a full facts pack: visibility, security, axe a11y, or tech facts.
What you can do with page checks
Focused single checks instead of a large facts pack: element visibility, security signals, axe a11y, or tech inventory — each with a clear endpoint.
- Visibility: exists, visible, in viewport, not obscured
- Security: TLS/header/mixed-content facts
- A11y: raw axe output
- Tech: framework/CMS/analytics hints
Switch endpoint — selector, viewport, and cookie banner are editable.
Structured check facts from the live endpoint.
Endpoints & parameters
Pick an endpoint for a sample request and a clear list of parameters.
POST /v1/checks/visibility
Checks a selector for visibility and optional expect rules.
Example request
{
"url": "https://example.com",
"selector": "a[href*=\"pricing\"]",
"scroll_into_view": true,
"dismiss_cookie_banner": true,
"expect": {
"href_contains": "pricing"
},
"width": 1280,
"height": 720
}Parameters
| Name | Type | Description |
|---|---|---|
urlreq | string | Target URL. |
selectorreq | string | CSS selector of the element. |
expect | object | Optional: attribute {name,value} or href_contains. |
scroll_into_view | boolean | Scroll element into viewport before check. |
ignore_selectors | string[] | Ignore overlays (e.g. cookie banner). |
wait_for_selector / settle_ms / timeouts | various | Timing control. |
width / height / dismiss_cookie_banner | various | Viewport and banner. |