Pricing

Rating

Developer

Actor stats

Categories

Share

Heading Structure Analyzer: Audit H1-H6 Hierarchy on Any Web Page

The heading structure of a page matters for SEO. Google uses heading tags to understand content organization, and common problems like a missing H1, duplicate H1s, or skipped heading levels are easy to fix once you know they exist. Finding them manually across hundreds of pages is not.

This actor fetches any URL, walks the DOM in document order, and returns every heading tag (H1 through H6) with its level, text, and position. It then checks the sequence for structural issues and lists them plainly. Run it on one page or batch-process up to 1,000 URLs in a single run.

Use cases

• SEO auditing: scan an entire site for broken heading hierarchy before publishing or after a CMS migration
• Content review: verify that blog posts and landing pages follow a logical H1-H2-H3 outline
• Technical SEO reports: pull heading data for all pages into a spreadsheet for client deliverables
• Pre-publish QA: check heading structure on new pages as part of a publishing checklist
• Competitor research: extract the heading outline from competitor pages to understand their content structure

Input

Example input

{
"urls":[
"https://apify.com",
"https://apify.com/about"
],
"maxUrls":50,
"requestTimeoutSecs":30,
"proxyConfiguration":{"useApifyProxy":true}
}

What data does this actor extract?

The actor stores one result per URL in a dataset. Each entry contains:

{
"url":"https://apify.com",
"inputUrl":"https://apify.com",
"pageTitle":"Apify: Full-Stack Web Scraping and Data Extraction Platform",
"h1Count":1,
"h2Count":6,
"h3Count":12,
"h4Count":0,
"h5Count":0,
"h6Count":0,
"headingTotalCount":19,
"headingDepth":3,
"hasMissingH1":false,
"hasMultipleH1":false,
"skippedLevels":[],
"hierarchyIssues":[],
"h1Texts":["Build reliable web scrapers. Fast."],
"headings":[
{"level":1,"text":"Build reliable web scrapers. Fast.","order":1},
{"level":2,"text":"Why Apify?","order":2}
],
"statusCode":200,
"errorMessage":"",
"scrapedAt":"2025-09-15T14:23:11.042Z"
}

How it works

1. Reads the url and urls inputs, deduplicates them, and caps the list at maxUrls
2. For each URL, sends an HTTP GET request with a realistic browser User-Agent
3. Parses the response HTML with BeautifulSoup and finds all H1-H6 tags in document order
4. Counts headings by level, records each heading's text and position
5. Walks the heading sequence to detect missing H1s, multiple H1s, and skipped levels
6. Pushes one result record per URL to the Apify dataset

Integrations

Connect Heading Structure Analyzer with other apps using Apify integrations. You can pipe results into Google Sheets, Zapier, Make, Slack, Airbyte, GitHub, or any tool that reads from the Apify API. You can also set up webhooks to trigger downstream actions when a run completes.

FAQ

Does this actor work on JavaScript-rendered pages? It works on standard server-rendered HTML. If the page requires JavaScript to render headings (single-page apps, React/Vue frontends), the headings may not appear in the raw HTML. For JS-heavy pages, consider a browser-based scraping approach.

What counts as a heading hierarchy issue? Three things: no H1 on the page, more than one H1, and skipped heading levels (e.g. the first heading after an H2 is an H4, skipping H3). All three are listed in the hierarchyIssues field with plain-language descriptions.

How many URLs can it process per run? Up to 1,000 URLs. Set maxUrls to cap the count if you want shorter runs during testing.

Do I need a proxy? Most public websites work fine without one. Enable datacenter proxies if you are hitting pages that rate-limit or block scrapers. Switch to residential proxies for sites that block datacenter IPs.

Why is errorMessage set but hierarchyIssues is empty? errorMessage fires when the page could not be fetched at all (network error, HTTP 4xx/5xx). hierarchyIssues only applies when the page loaded successfully but its heading structure has problems. They are independent.

Run heading structure analysis at scale

Manual heading audits break down past a few dozen pages. Heading Structure Analyzer runs the same check across hundreds of URLs in minutes and returns structured data you can sort, filter, and export. Pair it with a sitemap scraper to cover an entire site in one workflow.