Heading Structure Analyzer API

POST https://api.findutils.com/api/tools/heading-structure-analyzer/execute

Analyze the H1-H6 heading hierarchy of an HTML document and return every heading, SEO warnings (missing or multiple H1, skipped levels, empty or overly long headings), and per-level counts.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

html

string required

The HTML source to analyze (a full page or a fragment).
keyword

string optional

Optional target keyword. Each heading reports whether it contains this keyword (case-insensitive).

Example arguments

Verified

{
  "html": "<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>",
  "keyword": "seo"
}

curl -X POST https://api.findutils.com/api/tools/heading-structure-analyzer/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>",
    "keyword": "seo"
  }'

const response = await fetch('https://api.findutils.com/api/tools/heading-structure-analyzer/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"html":"<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>","keyword":"seo"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/heading-structure-analyzer/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"html":"<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>","keyword":"seo"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/heading-structure-analyzer/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"html":"<h1>SEO Guide</h1><h2>Keyword research</h2><h3>Long-tail keywords</h3>","keyword":"seo"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call heading_structure_analyzer from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: API key
REST id: heading-structure-analyzer
MCP name: heading_structure_analyzer
Category: SEO
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More SEO tools

More to explore