Pricing

Rating

Developer

Actor stats

Categories

Share

SEO Headings Structure Analyzer

This actor performs a complete audit of your page’s heading structure (H1–H6) to help you detect hierarchy problems, missing headings, or SEO issues that affect your site’s visibility and user experience.

You can analyze a single URL or configure a multi-page crawl for a broader audit. The actor scores each page, detects structural problems, and provides actionable recommendations based on SEO best practices..

Features

• Full H1–H6 Analysis: counts and inspects every heading tag on each page.
• SEO Scoring System: each page receives a score (0–100) and a letter grade (A–F).
• Issue Detection: flags missing or multiple H1s, hierarchy jumps, or consecutive same-level headings.
• Configurable Analysis: Choose what aspects to analyze (text, structure, scores).
• Actionable Recommendations: get suggestions like “Add H3 tags to improve content hierarchy”.
• Domain-Level Summary: aggregated metrics: heading averages, issue counts, score distribution.
• Flexible Setup: toggle between single-page or domain-level crawling.
• Developer-Friendly Output: clean JSON structure via Key-Value store or Dataset

Configuration Options

Crawling Behavior

The actor supports two analysis modes:

1. Single Page Analysis (Default): crawlUrls: false

   • Analyzes only the startUrl
   • Ignores the maxPages parameter
   • Fast and focused analysis

2. Multi-Page Crawling: crawlUrls: true

   • Crawls internal links starting from startUrl
   • Respects the maxPages parameter to limit crawling
   • Comprehensive domain analysis

Key Parameters

• startUrl: The URL to start analysis from
• crawlUrls: Boolean flag to enable/disable multi-page crawling (default: false)
• maxPages: Maximum number of pages to analyze (only applies when crawlUrls: true)

Output Format

{
"domain":{
"domain_name":"https://mysmartdigital.fr",
"total_pages_analyzed":1,
"total_headings":5,
"total_h1":1,
"total_h2":4,
"total_h3":0,
"total_h4":0,
"total_h5":0,
"total_h6":0,
"average_headings_per_page":5,
"average_h1_per_page":1,
"average_h2_per_page":4,
"average_h3_per_page":0,
"average_heading_score":73,
"pages_with_h1":1,
"pages_with_h1_percentage":100,
"pages_with_multiple_h1":0,
"pages_with_multiple_h1_percentage":0,
"pages_with_no_h1":0,
"pages_with_no_h1_percentage":0,
"pages_with_h2":1,
"pages_with_h2_percentage":100,
"pages_with_h3":0,
"pages_with_h3_percentage":0,
"pages_with_good_structure":1,
"pages_with_good_structure_percentage":100,
"total_heading_issues":1,
"critical_issues":0,
"warning_issues":1,
"info_issues":0,
"issues_by_type":{
"too many consecutive same level headings":[
{
"issue":"too many consecutive same level headings",
"page":"https://mysmartdigital.fr/",
"severity":"warning"
}
]
},
"analysis_summary":{
"has_heading_issues":true,
"needs_h1_improvement":false,
"has_good_structure":true,
"average_score_grade":"C"
}
},
"pages":[
{
"url":"https://mysmartdigital.fr/",
"pageStatusCode":200,
"analysis_date":"2025-10-19T15:01:31.723Z",
"data_source":"msd_headings",
"h1":[
"Agence WordPress"
],
"h2":[
"Un WordPress plus simple performant rapide intelligent",
"Développement de site WordPress",
"Maintenance de site WordPress",
"Optimisation des performances WordPress"
],
"h3":[],
"h4":[],
"h5":[],
"h6":[],
"h1Count":1,
"h2Count":4,
"h3Count":0,
"h4Count":0,
"h5Count":0,
"h6Count":0,
"totalHeadings":5,
"headingStructure":[
{
"tag":"h1",
"level":1,
"text":"Agence WordPress",
"position":1,
"length":16,
"wordCount":2
},
{
"tag":"h2",
"level":2,
"text":"Un WordPress plus simple performant rapide intelligent",
"position":2,
"length":55,
"wordCount":7
},
{
"tag":"h2",
"level":2,
"text":"Développement de site WordPress",
"position":3,
"length":31,
"wordCount":4
},
{
"tag":"h2",
"level":2,
"text":"Maintenance de site WordPress",
"position":4,
"length":29,
"wordCount":4
},
{
"tag":"h2",
"level":2,
"text":"Optimisation des performances WordPress",
"position":5,
"length":39,
"wordCount":4
}
],
"headingScore":73,
"headingIssues":[
"too many consecutive same level headings"
],
"headingRecommendations":[
"Consider adding H3 tags to create better content hierarchy",
"Good heading structure, consider minor improvements"
],
"pageTitle":"Agence Wordpress | Liberez le potentiel de votre site WordPress !"
}
],
"analysis":{
"total_pages_processed":1,
"analysis_completed_at":"2025-10-19T15:01:31.725Z",
"headings_engine_version":"1.0.0",
"data_format_version":"1.0"
}
}

How It Works

1. Fetches the specified page(s).
2. Extracts and parses all heading tags (H1–H6).
3. Builds a hierarchy tree and detects inconsistencies.
4. Scores each page using SEO and readability rules.
5. Returns a JSON object with domain summary, per-page data, and recommendations.

SEO Best Practices Analyzed

1. Single H1 per Page: ensures clear and unique page hierarchy
2. Logical Hierarchy: checks correct H1 → H2 → H3 nesting
3. Heading Length Optimization: detects too-short or too-long headings (ideal: 10–100 characters)
4. Keyword Relevance: evaluates heading context against page title for semantic alignment
5. Title vs H1 Differentiation: flags duplicated page titles and H1s
6. Content Organization: encourages balanced use of H2 and H3 tags for readability and SEO

Typical Use Cases

• SEO professionals auditing heading structure before a crawl or migration.
• Content editors checking that pages follow proper H1–H6 hierarchy.
• Developers validating new templates before deployment.

Support

For issues and questions, please contact My Smart Digital support.