POST AI agent ready /v1/accessibility/check

Website Accessibility Check API - Free A11y Audit

Fetches a URL and runs 10 rule-based accessibility checks on the HTML. Checks include: images missing alt text, missing html lang attribute, missing page title, empty links, empty buttons, heading order violations, missing viewport meta, form inputs without labels, missing skip navigation, and duplicate IDs. Returns a 0-100 score, an issues list with severity and count, and a summary.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/accessibility/check \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

When to use this API

Add accessibility checks to your CI/CD pipeline

Call this endpoint in your deployment pipeline after staging deploys. Fail the build if the accessibility score drops below a threshold or if error-severity issues are detected. Catches regressions before they reach production.

Audit client websites for accessibility compliance

Agencies and consultants can scan client sites and generate a baseline report of accessibility issues. Prioritize fixes by severity and track score improvements over time.

Monitor competitor accessibility over time

Track accessibility scores for competitor sites or industry benchmarks. Compare your site score against the competition in quarterly reports.

Frequently asked questions

Is this a full WCAG 2.1 audit?

No. This runs 10 common checks that catch the most frequent accessibility issues. For a full WCAG 2.1 audit, use a tool like axe-core or Lighthouse. This endpoint is a quick first pass, not a compliance certification.

What does the score mean?

The score is the percentage of checks that pass (0-100). A score of 70 means 7 out of 10 checks passed. Higher is better. A perfect 100 does not guarantee full WCAG compliance.

Can I check pages that require authentication?

No. The endpoint fetches the URL as an anonymous visitor. Pages behind login walls will return the login page HTML, not the authenticated content.

Does this execute JavaScript?

No. The endpoint fetches the raw HTML response. Single-page applications that render content via JavaScript will be checked against their initial HTML shell, which may miss dynamically loaded content.

What is the difference between errors and warnings?

Errors are issues that directly prevent users from accessing content (missing alt text, missing title). Warnings are issues that degrade the experience but do not fully block access (heading order, missing skip nav).

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.