ScoutAPI in development · launch 1 Dec 2026. Try it live · docs

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
API Call
editable
Request bodyJSON
{'{'}
:,
:,
:,
:
{'}'}

Switch endpoint — selector, viewport, and cookie banner are editable.

Security check
example.com

Structured check facts from the live endpoint.

Run a check to see the live result payload.
No request yet
{
  "message": "Not run yet"
}

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

NameTypeDescription
urlreqstringTarget URL.
selectorreqstringCSS selector of the element.
expectobjectOptional: attribute {name,value} or href_contains.
scroll_into_viewbooleanScroll element into viewport before check.
ignore_selectorsstring[]Ignore overlays (e.g. cookie banner).
wait_for_selector / settle_ms / timeoutsvariousTiming control.
width / height / dismiss_cookie_bannervariousViewport and banner.