Web Accessibility Scanner

Web Accessibility Scanner

Web Accessibility Scanner is an Actor that scans websites for accessibility issues, ensuring they comply with the Web Content Accessibility Guidelines (WCAG). It can perform both single page scans and domain-wide scans, with the option to bypass login walls for specific pages.

Features

• Domain-wide Scanning: Check all pages within a domain for accessibility issues.
• Single Page Scanning with Login Bypass: Allows scanning of a specific page behind a login wall (available for single page scans only).
• Detailed Reports: Provides comprehensive output highlighting accessibility errors, contrast issues, and warnings.

How to Check a Website for Accessibility

1. Add URLs: Provide one or more URLs to scan. You can either enter them manually or upload from a .txt file or a Google Sheet.
2. Start the Scan: Click the "Start" button and the actor will begin scanning.
3. Download Results: Once the scan is complete, you can download the data in various formats, including JSON, XML, CSV, Excel, or HTML.

Input Parameters

• Start URLs: The URLs to be scanned for accessibility issues.
• Source Options:
  • Direct input of URLs.
  • Upload a .txt file with URLs (one URL per line).
  • Import URLs from a Google Sheet (ensure URLs are in the first column). Check here for more details.
• Login Bypass: For single page scans, enable this option to bypass login walls (not available for domain-wide scans).
• Note: If the option to scan full website or bypass login page is enabled, only the first URL on the Start URLs list will be considered.

For more information, refer to the Input tab.

Output

The results from the accessibility scan is saved in the Apify dataset and can be downloaded in multiple formats such as JSON, HTML, XML, CSV, or Excel.

Example JSON Output

1[
2  {
3    "url": "https://www.apify.com/",
4    "status": "Scan Successful",
5    "criticalErrors": [
6      {
7        "code": "Principle1.Guideline1_1.1_1_1.H37",
8        "message": "Img element missing an alt attribute.",
9        "selector": "body > img:nth-child(38)",
10        "context": "<img src=\"https://t.co/1/i/adsct?bci=4&amp;eci=3&amp;event=%7B%7D&amp;event_id=b194fd56-60f9-4152-ada9-76f7c38bd264&amp;integration=gtm&amp;p_id=Twitter&amp;p_user_id=0&amp;pl_id=0ccf5eff-d6f8-4f6e-bef3-cfce4b1279b8&amp;tw_document_href=https%3A%2F%2Fapify.com%2F&amp;tw_iframe_status=0&amp;txn_id=omnsj&amp;type=javascript&amp;version=2.3.30\" height=\"1\" width=\"1\" style=\"display: none;\">",
11        "type": "error"
12      }
13    ],
14    "contrastErrors": [
15      {
16        "code": "Principle1.Guideline1_4.1_4_3.G18_or_G145.Fail",
17        "message": "Insufficient contrast ratio. Expected 4.5:1, found 3.75:1.",
18        "selector": "body > footer > div:nth-child(1) > p",
19        "context": "<p>Join our developer community on Discord</p>",
20        "type": "contrast error"
21      }
22    ],
23    "warnings": [
24      {
25        "code": "Principle1.Guideline1_3.1_3_1.H42",
26        "message": "Heading markup should be used if this content is intended as a heading.",
27        "selector": "#main > div:nth-child(2) > section:nth-child(4) > div > a",
28        "context": "<span><strong>Web scraping academy</strong></span>",
29        "type": "warning"
30      }
31    ]
32  }
33]

Technical Requirements

• Apify Account: You need an active Apify account to use this actor.
• Input URLs: URLs can be provided via direct input, a .txt file, or a Google Sheet (ensure URLs are in the first column).
• Login Bypass: This feature works only for single-page scans and is not available for full-domain scanning.

Troubleshooting

If you encounter any issues while using this actor, consider the following:

• Verify URLs: Ensure that the URLs provided are valid and accessible.
• Input Format: If using a .txt file or Google Sheet, ensure the URLs are in the correct format.
• Login Bypass: If scanning behind a login wall, ensure that the correct login credentials are provided, and the page is accessible after logging in.

For more support, visit the Apify Documentation or contact Apify Support.

Feedback

If you have any technical feedback, suggestions for improvement, or if you've encountered a bug with the Website Accessibility Scanner, please feel free to create an issue in the Actor's Issues tab on the Apify Console.