SEO H1-H6 Headings Checker

Overview

This actor audits a webpage's heading structure (H1 through H6) to identify SEO and hierarchy issues. It analyzes a single URL or crawls multiple pages from a starting point, providing scores, detecting problems, and giving actionable recommendations.

Key Features

• Complete H1-H6 Analysis: Counts and inspects every heading tag on a page.
• SEO Scoring: Assigns each page a numerical score (0-100) and a letter grade (A-F).
• Issue Detection: Flags common problems like missing or multiple H1 tags, hierarchy jumps (e.g., H1 to H3), and too many consecutive headings at the same level.
• Configurable Analysis: Control which aspects of the heading structure are analyzed.
• Actionable Output: Provides specific suggestions for improvement, such as "Add H3 tags to improve content hierarchy."
• Domain-Level Summary: When crawling multiple pages, aggregates metrics like average headings per page, issue counts, and score distribution.
• Flexible Setup: Toggle between a fast single-page analysis or a comprehensive multi-page crawl.
• Structured Output: Returns clean, developer-friendly JSON via Apify's Key-Value store or Dataset.

How to Use

Configure the actor using these primary parameters:

• startUrl: The URL to begin analysis.
• crawlUrls: A boolean (true/false) that sets the analysis mode.
  • false (Default - Single Page): Analyzes only the startUrl. The maxPages parameter is ignored.
  • true (Multi-Page Crawl): Crawls internal links starting from the startUrl for a domain-wide audit.
• maxPages: The maximum number of pages to analyze. This parameter is only used when crawlUrls is set to true.

Input/Output

The actor requires a startUrl as input. The primary output is a detailed JSON report.

A condensed example of the output structure is shown below. The full report includes extensive page-level and domain-level details.

{
  "domain": {
    "domain_name": "https://example.com",
    "total_pages_analyzed": 1,
    "average_heading_score": 73,
    "total_heading_issues": 1,
    "analysis_summary": {
      "has_heading_issues": true,
      "average_score_grade": "C"
    }
  },
  "pages": [
    {
      "url": "https://example.com/",
      "h1": ["Page Title"],
      "h2": ["Section 1", "Section 2"],
      "h1Count": 1,
      "h2Count": 2,
      "totalHeadings": 3,
      "headingStructure": [
        { "tag": "h1", "text": "Page Title" },
        { "tag": "h2", "text": "Section 1" }
      ]
    }
  ]
}

The complete output contains aggregated domain statistics and per-page data, including all heading texts, counts, structural details, and a list of any issues found.