SEO Scanner Documentation
SEO Scanner is a technical SEO platform for full-site crawling, technical checks, content analysis, schema validation, broken-link detection, WHOIS lookups, and export-ready reports. This documentation covers the product, account-based API access, and the downloadable files you can use in your workflow.
What SEO Scanner Covers
SEO Scanner is designed for technical audits, content quality reviews, and operational reporting. It focuses on the parts of SEO that teams need to diagnose quickly: crawlability, on-page markup, duplication, structured data, images, content quality, security, and broken links. Public API access is available for page analysis, WHOIS/RDAP lookup, and sitemap discovery.
Scan Modes
Single Page Analysis
Use this mode when you need a focused audit for one URL. It returns core SEO checks, content analysis, schema validation, link metrics, image diagnostics, security headers, and export-ready page data.
- Fast page-level diagnosis
- Ideal for QA, templates, and landing pages
- No deep crawling required
Full Website Crawl
SEO Scanner looks for a sitemap first. If none is found, it falls back to deep crawling to discover indexable URLs. This mode powers site-wide issue summaries, duplicate detection, internal-link insights, and richer exports.
- Sitemap discovery + fallback deep crawl
- Issue aggregation across all pages
- Built for site audits and client deliverables
Technical SEO Coverage
Technical checks are the core of the scanner. Every analyzed page is inspected for title length, meta description quality, heading structure, canonical usage, robots/indexability signals, Open Graph, Twitter Cards, hreflang, structured data, image hygiene, redirects, HTTP status, and security headers.
- Title, meta description, H1/H2/H3 consistency
- Canonical and robots checks
- Open Graph, Twitter, hreflang, and JSON-LD detection
- Image alt text, dimensions, and lazy-loading signals
- Redirect chains, HTML size, load time, and HTTP status checks
- Security headers: HSTS, CSP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy and more
Structured Data Validation
The schema panel validates JSON-LD blocks, detects rich-result candidates, surfaces missing properties, and shows raw markup for debugging.
Organization WebSite SoftwareApplication FAQPage BreadcrumbList WebApplicationContent Analysis
SEO Scanner also evaluates content quality signals. This is separate from PageSpeed and focuses on what helps content teams and SEO specialists improve clarity, relevance, and crawlable on-page depth.
Readability
Sentence length, readability score, and content difficulty classification.
Density Signals
Top keywords, bigrams, trigrams, and keyword stuffing detection.
Content Depth
Word count, sentence count, paragraph count, and text/HTML ratio.
Links, Security, and Reporting
Links & Broken Links
Inspect internal vs external links, nofollow usage, empty anchors, and broken-link results. The links tab is useful for auditing navigation, orphan-risk patterns, and content hubs.
Exports & Delivery
Generate PDF, CSV, JSON, or HTML output. PDF reports are designed for agency-ready executive summaries plus per-page technical detail. Email sending is also supported directly from the app.
API Reference
The API requires a logged-in account with API access enabled in settings. Use your authenticated session when calling these endpoints. It exposes page analysis, WHOIS/RDAP lookup, and sitemap discovery. PageSpeed is intentionally excluded from the API.
Tip: the API is session-based, so curl clients must send the logged-in cookie from your browser session.
Base URL
POST /analyze
Analyze a single page and return technical SEO, schema, content, image, link, and security data.
POST /whois
Fetch RDAP / WHOIS data for a domain or URL.
POST /sitemap
Discover and parse the sitemap for a website, including common fallback locations.
GET /api/site/:domain
Return the latest public snapshot and history for a domain.
GET /api/badge/:slug
Return the embeddable score badge for a public report.
GET /api/og/:slug
Return the Open Graph image for a public report.
POST /api/vitals
Send Core Web Vitals from the browser for aggregation.
Downloadable Files
Use these files to integrate the API into internal tools, collections, onboarding docs, or client handoff packages.
OpenAPI JSON
Machine-readable API definition for SDKs, tooling, and import workflows.
/docs-files/openapi.json
OpenAPI YAML
Human-friendly OpenAPI version for editing and documentation generators.
/docs-files/openapi.yaml
Postman Collection
Ready-to-import requests for the account-based API endpoints and browser vitals.
/docs-files/seoscanner-postman-collection.json
Quickstart Markdown
Shareable technical onboarding doc for teams and clients.
/docs-files/quickstart.md
FAQ
Does the API include PageSpeed?
No. The product UI supports PageSpeed analysis, but the API is intentionally limited to technical SEO analysis, WHOIS/RDAP, and sitemap discovery.
Can I use SEO Scanner for client reporting?
Yes. The PDF export is designed for professional delivery, while CSV, JSON, and HTML exports support internal analysis and automation.
Do I need an API key?
No API key, but you need a free account. Enable API access in your account settings and use your session cookie.
What is rate limited?
All public endpoints are limited to 30 requests per minute per IP address. Standard rate-limit headers are returned with each response.