Heading Structure Checker

Pricing

Rating

Developer

Actor stats

Categories

Share

Analyze heading hierarchy (H1-H6) on web pages. Check for missing H1, skipped levels, and heading order issues.

What does Heading Structure Checker do?

This actor analyzes the heading structure (H1-H6) of web pages. It extracts all headings in document order, checks for missing H1, multiple H1s, skipped heading levels, heading order jumps, empty headings, and overly long headings. Essential for SEO and accessibility.

Search engines use heading tags to understand the topical structure of a page, and screen readers depend on them for navigation. A broken heading hierarchy -- such as jumping from H1 to H4 or having multiple H1 tags -- hurts both SEO performance and accessibility compliance. This actor gives you a complete heading audit for any number of pages.

The output includes full heading counts by level (H1-H6), the maximum depth used, and a complete list of all headings in document order with their text and character length. This makes it easy to reconstruct the page outline and spot structural problems at a glance.

Use cases

• SEO specialist -- audit heading structure across an entire site to ensure search engines can parse content hierarchy correctly
• Accessibility tester -- verify that heading levels follow WCAG 2.1 guidelines so screen reader users can navigate the page
• Content editor -- review heading usage in blog posts and articles to ensure logical document outlines before publishing
• Web developer -- validate heading structure after template changes or CMS updates that may break heading order
• QA engineer -- add heading structure checks to automated testing pipelines for regression detection
• Agency team lead -- include heading validation in client-facing technical SEO audits and reports

Why use Heading Structure Checker?

• Complete heading extraction -- returns every heading (H1-H6) with its level, tag, text, and character length
• Six issue types detected -- missing H1, multiple H1s, skipped levels, empty headings, overly long headings, and heading order jumps
• Batch processing -- analyze hundreds of pages in a single run
• Structured JSON output -- heading counts, max depth, full heading list, and issues array ready for processing
• Fast and lightweight -- uses direct HTTP requests without a browser for quick results
• Pay-per-event pricing -- costs just $0.001 per page checked

Input parameters

Input example

{
"urls":[
"https://www.google.com",
"https://en.wikipedia.org/wiki/Web_scraping",
"https://example.com"
]
}

Output example

{
"url":"https://en.wikipedia.org/wiki/Web_scraping",
"title":"Web scraping - Wikipedia",
"headingCounts":{"h1":1,"h2":12,"h3":5,"h4":0,"h5":0,"h6":0,"total":18},
"hasH1":true,
"multipleH1":false,
"skippedLevels":[],
"maxDepth":3,
"headings":[
{"level":1,"tag":"h1","text":"Web scraping","length":12},
{"level":2,"tag":"h2","text":"Contents","length":8}
],
"issues":[],
"error":null,
"checkedAt":"2026-03-01T12:00:00.000Z"
}

How to check heading structure on a website

1. Go to Heading Structure Checker on Apify Store
2. Enter the URLs of the pages you want to audit
3. Click Start and wait for results
4. Review the heading hierarchy, issues, and scores for each page
5. Download results as JSON, CSV, or Excel

How much does it cost to check heading structure?

Example costs:

• 10 URLs: $0.035 + (10 x $0.001) = $0.045
• 100 URLs: $0.035 + (100 x $0.001) = $0.135
• 1,000 URLs: $0.035 + (1,000 x $0.001) = $1.035

Using the Apify API

You can call Heading Structure Checker programmatically from your own applications using the Apify API. The following examples show how to start a run, wait for it to finish, and retrieve the results.

Node.js

import{ ApifyClient }from'apify-client';
const client =newApifyClient({token:'YOUR_TOKEN'});
const run =await client.actor('automation-lab/heading-structure-checker').call({
urls:['https://en.wikipedia.org/wiki/Web_scraping'],
});
const{ items }=await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')
run = client.actor('automation-lab/heading-structure-checker').call(run_input={
'urls':['https://en.wikipedia.org/wiki/Web_scraping'],
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)

cURL

curl"https://api.apify.com/v2/acts/automation-lab~heading-structure-checker/runs"\
-X POST \
-H"Content-Type: application/json"\
-H"Authorization: Bearer YOUR_TOKEN"\
-d'{"urls": ["https://en.wikipedia.org/wiki/Web_scraping"]}'

Use with AI agents via MCP

Heading Structure Checker is available as a tool for AI assistants via the Model Context Protocol (MCP).

Setup for Claude Code

$claude mcp add--transport http apify "https://mcp.apify.com?tools=automation-lab/heading-structure-checker"

Setup for Claude Desktop, Cursor, or VS Code

{
"mcpServers":{
"apify":{
"url":"https://mcp.apify.com?tools=automation-lab/heading-structure-checker"
}
}
}

Example prompts

• "Check the heading hierarchy on this page"
• "Audit H1-H6 structure for these URLs"

Learn more in the Apify MCP documentation.

Integrations

Heading Structure Checker works with all major automation and integration platforms available on Apify. Connect it to Make (formerly Integromat) or Zapier to create workflows that flag pages with heading issues. Export results to Google Sheets for easy review and prioritization by your content or development team. Send Slack notifications when pages fail heading validation. Use webhooks to receive instant callbacks when a run completes, or build advanced automation pipelines with n8n. Schedule recurring runs on Apify to catch heading issues introduced by new content or template changes. All results are stored in Apify datasets and can be downloaded in JSON, CSV, or Excel format.

Tips and best practices

• Every page should have exactly one H1 -- multiple H1 tags confuse search engines about the primary topic of the page
• Never skip heading levels -- going from H2 to H4 breaks the document outline for both SEO and screen readers
• Keep headings under 70 characters -- overly long headings dilute their SEO value and are harder for users to scan
• Check after CMS or template changes -- theme updates and CMS migrations are the most common cause of broken heading structures
• Use the headings array for content audits -- the full list of headings gives you a quick outline of any page's content structure
• Pay attention to empty headings -- headings with no text content are invisible to users but confuse screen readers and waste heading hierarchy

Legality

This tool analyzes publicly accessible web content. Automated analysis of public web resources is standard practice in SEO and web development. Always respect robots.txt directives and rate limits when analyzing third-party websites. For personal data processing, ensure compliance with applicable privacy regulations.

FAQ

Why does heading structure matter for SEO? Search engines use headings to understand the topical hierarchy of a page. A clear H1 followed by logically nested H2s and H3s helps Google determine what the page is about and which sections are most important.

What is a skipped heading level? A skipped level occurs when a heading jumps more than one level, such as an H2 followed directly by an H4 with no H3 in between. This breaks the logical document outline and can confuse both search engines and assistive technologies.

Does this actor check heading content quality? The actor checks structural issues (missing, multiple, skipped, empty, too long) but does not evaluate whether heading text is well-written or includes target keywords. For keyword analysis, use the Keyword Density Analyzer actor.

Is it okay to have multiple H2 or H3 tags? Yes. Having multiple H2 and H3 tags is perfectly normal and expected. The only heading level that should appear exactly once is H1. Lower-level headings should be used as many times as needed to structure the content logically.

What is considered an overly long heading? Headings longer than 70 characters are flagged as overly long. While there is no strict SEO rule, shorter headings are easier for users to scan and more effective as search result snippets.

How many URLs can I check in one run? There is no hard limit. You can check hundreds or thousands of pages in a single run. The actor processes each URL independently and concurrently for efficient results.

Does the actor work with JavaScript-rendered pages? The actor fetches the raw HTML of each page. If headings are injected by client-side JavaScript and not present in the initial HTML response, they will not be detected. Most CMS platforms render headings in the initial HTML, so this is rarely an issue in practice.

The actor reports "no H1" but my page has an H1 when viewed in the browser. Why? The actor fetches the raw HTML of each page without executing JavaScript. If your H1 is injected by client-side JavaScript (e.g., a React or Angular app), it will not be present in the initial HTML response. Most CMS platforms render headings server-side, but single-page applications may need server-side rendering (SSR) for headings to be visible to both the actor and search engine crawlers.

The heading count is much higher than expected. What could cause this? The actor extracts all heading elements (H1-H6) from the HTML, including headings in navigation menus, sidebars, footers, and widget areas. Many site templates use headings in these regions for semantic structure. Focus on the headings array to identify which headings are from the main content versus template elements.

Other SEO tools

• Hreflang Checker — Validate hreflang tags for international SEO
• HTML Validator — Check HTML structure, doctype, charset, and deprecated elements
• HTTP Headers Security Checker — Analyze HTTP security headers with A+ to F grading
• HTTP Status Checker — Check HTTP status codes, redirects, and response times
• Iframe Detector — Detect and categorize embedded iframes on web pages
• Image Alt Checker — Check images for missing or poor alt text
• Accessibility Checker — Audit web pages for WCAG accessibility compliance
• SEO Title Checker — Validate page titles for SEO best practices
• Broken Link Checker — Find broken links across your website
• Website Health Report — Comprehensive website health and SEO audit