---
title: Audit Webpage Accessibility API
slug: audit-webpage-accessibility
url: https://apyhub.com/seoscoreapi/service/audit-webpage-accessibility
provider: SEO Score API
categories: [Safety Kit, Media Kit]
tags: [accessibility, wcag, ada-compliance, web-audit, tracker-detection]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 1000
mcp: true
---

# Audit Webpage Accessibility API

Check a URL for ADA and WCAG 2.1 AA issues. Optionally include tracker and pixel inventory in the audit report.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/seoscoreapi/audit-webpage-accessibility` | What it does Runs a WCAG 2.1 AA accessibility audit of a page in a real browser. Returns an accessi… | 1000 |

## Endpoint reference

### ADA / WCAG 2.1 AA accessibility audit

`GET https://api.eu.apyhub.com/seoscoreapi/audit-webpage-accessibility` · 1000 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | The page to audit for ADA / WCAG 2.1 AA accessibility, as a full URL including `https://`. Example: `https://www.wikipedia.org`. |
| `include` | query | string | no | `trackers` adds the tracker and pixel inventory to the report |

#### Quickstart

Audit a webpage for ADA/WCAG compliance by passing the target URL as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/seoscoreapi/audit-webpage-accessibility?url=https%3A%2F%2Fwww.wikipedia.org" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

A real response to the request above, with every array cut to its first 2 items:

```json
{
  "url": "https://www.wikipedia.org/",
  "score": 100,
  "grade": "A+",
  "standard": "WCAG 2.1 AA",
  "response_code": 200,
  "summary": {
    "total_rules_checked": 51,
    "violations": 0,
    "passes": 32,
    "incomplete": 2,
    "best_practice_issues": 1
  },
  "lawsuit_risk": {
    "level": "minimal",
    "summary": "No automated WCAG 2.1 AA violations detected. 1 best-practice suggestion(s) are listed under best_practices; they are not WCAG requirements and don't affect the score or risk level. 2 check(s) need manual review (see needs_review).",
    "high_risk_violations": []
  },
  "categories": {
    "aria": {
      "label": "ARIA Attributes",
      "score": 100.0,
      "violations": 0,
      "passes": 7,
      "issues": []
    },
    "color_contrast": {
      "label": "Color Contrast",
      "score": 100.0,
      "violations": 0,
      "passes": 2,
      "issues": []
    },
    "forms": {
      "label": "Forms & Labels",
      "score": 100.0,
      "violations": 0,
      "passes": 3,
      "issues": []
    },
    "images": {
      "label": "Images & Alt Text",
      "score": 100.0,
      "violations": 0,
      "passes": 2,
      "issues": []
    },
    "keyboard": {
      "label": "Keyboard & Navigation",
      "score": 100.0,
      "violations": 0,
      "passes": 2,
      "issues": []
    },
    "links_buttons": {
      "label": "Links & Buttons",
      "score": 100.0,
      "violations": 0,
      "passes": 3,
      "issues": []
    },
    "other": {
      "label": "Other",
      "score": 100.0,
      "violations": 0,
      "passes": 9,
      "issues": []
    },
    "structure": {
      "label": "Document Structure",
      "score": 100.0,
      "violations": 0,
      "passes": 3,
      "issues": []
    },
    "viewport": {
      "label": "Viewport & Zoom",
      "score": 100.0,
      "violations": 0,
      "passes": 1,
      "issues": []
    }
  },
  "violations": [],
  "best_practices": [
    {
      "rule_id": "heading-order",
      "impact": "moderate",
      "type": "best_practice",
      "description": "Ensure the order of headings is semantically correct",
      "help": "Heading levels should only increase by one",
      "help_url": "https://dequeuniversity.com/rules/axe/4.10/heading-order?application=axeAPI",
      "wcag_tags": [],
      "category": "structure",
      "fix": "Don't skip heading levels: an <h2> should follow an <h1>, an <h3> an <h2>. Change the tag, not just the font size.",
      "affected_elements": 1,
      "element_samples": [
        {
          "html": "<h3>",
          "target": [
            ".overlay-banner-mini-message-text.overlay-banner-control > h3"
          ],
          "fix_suggestion": "Don't skip heading levels: an <h2> should follow an <h1>, an <h3> an <h2>. Change the tag, not just the font size.",
          "failure_summary": "Fix any of the following:\n  Heading order invalid"
        }
      ]
    }
  ],
  "needs_review": [
    {
      "rule_id": "color-contrast",
      "type": "wcag",
      "impact": "serious",
      "description": "Ensure the contrast between foreground and background colors meets WCAG 2 AA minimum contrast ratio thresholds",
      "help": "Elements must meet minimum color contrast ratio thresholds",
      "help_url": "https://dequeuniversity.com/rules/axe/4.10/color-contrast?application=axeAPI",
      "wcag_tags": [
        "wcag2aa",
        "wcag143"
      ],
      "what_to_check": "Contrast couldn't be measured automatically, usually because the text sits on a background image, gradient, or an overlapping element. Check it with a contrast checker: 4.5:1 for normal text, 3:1 for large text.",
      "affected_elements": 10,
      "element_samples": [
        {
          "html": "<a href=\"https://donate.wikimedia.org/?wmf_medium=portal&amp;wmf_campaign=portalBanner&amp;wmf_source=portalBanner_en6C_2627_1102_YoYTestCBCopy&amp;uselang=en&amp;appeal=SupportingWikipedia\" id=\"frb-d",
          "target": [
            "#frb-donate"
          ],
          "reason": "Element's background color could not be determined because it's partially obscured by another element"
        },
        {
          "html": "<p>Proud host of Wikipedia and other free knowledge projects</p>",
          "target": [
            ".overlay-banner-main-footer-identity > p"
          ],
          "reason": "Element's background color could not be determined because it's partially obscured by another element"
        }
      ]
    },
    {
      "rule_id": "link-in-text-block",
      "type": "wcag",
      "impact": "serious",
      "description": "Ensure links are distinguished from surrounding text in a way that does not rely on color",
      "help": "Links must be distinguishable without relying on color",
      "help_url": "https://dequeuniversity.com/rules/axe/4.10/link-in-text-block?application=axeAPI",
      "wcag_tags": [
        "wcag2a",
        "wcag141"
      ],
      "what_to_check": "Check that links in body text can be told apart from the text around them without relying on color.",
      "affected_elements": 2,
      "element_samples": [
        {
          "html": "<a class=\"frb-link-privacy\" href=\"https://foundation.wikimedia.org/wiki/Special:MyLanguage/Policy:Donor_privacy_policy?uselang=en\" target=\"_blank\">donor privacy policy</a>",
          "target": [
            ".frb-link-privacy"
          ],
          "reason": "Element's foreground contrast ratio could not be determined"
        },
        {
          "html": "<a class=\"frb-link-tax\" href=\"https://wikimediafoundation.org/give/donor-frequently-asked-questions/#tax-deductibility\" target=\"_blank\">Wikimedia Foundation</a>",
          "target": [
            ".frb-link-tax"
          ],
          "reason": "Element's foreground contrast ratio could not be determined"
        }
      ]
    }
  ],
  "priorities": [
    {
      "severity": "low",
      "impact": "moderate",
      "type": "best_practice",
      "rule_id": "heading-order",
      "issue": "Heading levels should only increase by one",
      "fix": "Don't skip heading levels: an <h2> should follow an <h1>, an <h3> an <h2>. Change the tag, not just the font size.",
      "help_url": "https://dequeuniversity.com/rules/axe/4.10/heading-order?application=axeAPI",
      "affected_elements": 1
    }
  ]
}
```

## About

## What it does
Accessibility Audit checks a page URL for ADA and WCAG 2.1 AA accessibility issues. Send a `url`, and you get back the audit result for that page. If you include `trackers`, the report also adds tracker and pixel inventory details.

Use Accessibility Audit when you need a fast pre-check before publishing a landing page, product page, or marketing site. It helps you spot accessibility gaps early in your build or QA flow, before they become release blockers or compliance issues.

It has one endpoint, `ADA / WCAG 2.1 AA accessibility audit`.

The JSON response lists every WCAG violation with affected elements and a fix, items that need a human check, and a prioritized fix list.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/seoscoreapi/service/audit-webpage-accessibility
