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.
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
The URL to audit for ADA/WCAG compliance
trackers adds the tracker and pixel inventory to the report
Headers
Your API key
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.