Ada Audit

Run an ADA / WCAG 2.1 AA accessibility compliance audit. Paid plans only.

Returns a detailed accessibility report including:

  • Overall compliance score and grade (WCAG 2.1 A/AA rules only)
  • Lawsuit risk assessment (high/medium/low/minimal)
  • Category breakdowns (images, forms, contrast, keyboard, ARIA, etc.)
  • violations: WCAG 2.1 AA failures, with affected elements and a plain-English fix
  • best_practices: axe best-practice findings (e.g. heading-order). Not WCAG requirements, so they never lower the score or raise the risk level
  • needs_review: checks axe couldn't decide automatically, with what to verify by hand. They are excluded from the score rather than counted as failures
  • priorities: WCAG violations first, then best practices. severity maps from axe impact one-to-one: critical→critical, serious→high, moderate→medium, minor→low (best practices are always low)

Limits. ADA audits have their own monthly allowance (ada_monthly: Starter 5, Basic 20, Pro 100, Ultra 500), separate from your audit quota. Each key may run 20 ADA audits per minute and 2 at a time; the tier rpm does not apply here. GET /usage reports ada_usage_this_month and ada_remaining. A 429 includes Retry-After, and a 429 is never counted against ada_monthly (nor is any failed audit).

Errors. A page we can't load returns 422 with detail (message) and reason: blocked (the site refused our crawler), timeout, dns, tls, unreachable, not_found, http_error, non_html, redirect_loop, blocked_url, load_failed. A URL we refuse up front (private/internal address, malformed URL) is 400 with reason blocked_url / invalid_url. A 502 means the failure was on our side.

Uses the axe-core accessibility engine (industry standard) to check against WCAG 2.1 Level AA — the standard referenced in most ADA lawsuits.

get/audit/accessibility

Request

  • Base URL: https://seoscoreapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://seoscoreapi.com/audit/accessibility
  • Auth: none declared. Required headers: X-API-Key

Query parameters

urlstring required

The URL to audit for ADA/WCAG compliance

includestring nullable

trackers adds the tracker and pixel inventory to the report

Headers

X-API-Keystring required

Your API key

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.