Skip to content
https://swagger.io

SEO

· 7 checks — Canonical, meta, content depth, internal links, image SEO, and hreflang rolled into one auditable list.
SCORE
87
GRADE
B
FIX
0
REVIEW
2
PASS
4
INFO
1

Cross-tab audit — SEO, performance, crawlability, mobile, structured data

Checks
7
4 PASS 2 REVIEW
B
Canonical URL
Minor issues
REVIEW
Minor issues
Warning::
No canonical tag found
Search engines will determine the canonical URL themselves, which may cause duplicate content issues.
No Canonical URL Set
Page URL https://swagger.io Canonical (not set)

Search engines will determine the canonical URL themselves, which may cause duplicate content issues.

Why this matters

Without a canonical, Google may treat each URL variant (with/without slash, with tracking params, http/https) as duplicate content and split ranking.

Learn more

A canonical link tells Google which URL is the 'real' one when multiple URLs serve identical content. Without it, link equity gets split across variants and none of them rank as well as a single canonical version would. One <link rel="canonical"> tag in <head> covers it.

Source: Google Search Central

C
Content Depth
Action
570 words, Very Difficult
REVIEW
570 words, Very Difficult
Info::
Page has 570 words of content
Info::
Text-to-HTML ratio is 3%
Very low ratio suggests heavy framework overhead or boilerplate.
Info::
Reading level: Very Difficult (grade 16)
570 words

Good depth

Reading level

Very Easy
Easy
Fairly Easy
Standard
Fairly Difficult
Difficult
Very Difficult

Grade 16

Text-to-HTML Ratio

3% text 97% HTML

4 KB / 155 KB

Very low ratio suggests heavy framework overhead or boilerplate.

Why this matters

Informational: ratio of visible text bytes to total HTML bytes. Very low ratios suggest excessive markup overhead.

A+
Meta Tags
Title optimized
PASS
Title optimized
Info::
Page title is set
Got: API Documentation & Design Tools for Teams | Swagger
Info::
Title length (52 chars) is optimal
Info::
Title and H1 have very different wording
Alignment helps users confirm they've reached the right page.
Title

"API Documentation & Design Tools for Teams | Swagger"

52 characters Optimal ✓
Title: API Documentation & Design Tools for Teams | Swagger
H1: The Future of AI Relies on API Quality
Match: Very different
Robots: Indexable (no restrictions)

Alignment helps users confirm they've reached the right page.

Why this matters

Title and H1 disagree significantly — Google may treat one as the canonical topic and the other as off-topic, weakening ranking.

Learn more

Title is the SERP headline; H1 is the on-page headline. They should describe the same page. Large divergence (different topics, different keywords) signals confusion and Google may rewrite the title in SERP. Align both to the same primary topic.

Source: Google Search Central / on-page SEO

A+
Image SEO
26 images, 26 descriptive filenames
PASS
26 images, 26 descriptive filenames
Info::
All images have descriptive filenames
Info::
15 image(s) missing alt text — see Accessibility tab
26 descriptive
0 hash-based
0 generic
26 total
FilenameQualityAltIssues
SW_Menu1_1_CLR.svgdescriptive1
SW_Menu1_2_CLR.svgdescriptive1
SW_Menu1_3_CLR.svgdescriptive1
SW_Menu1_4_CLR.svgdescriptive1
SW_Menu1_5_CLR.svgdescriptive1
SW_Menu1_6_CLR.svgdescriptive1
SW_Menu1_7_CLR.svgdescriptive1
SW_Menu1_8_CLR.svgdescriptive1
SW_Menu3_1_CLR.svgdescriptive1
SW_Menu3_2_CLR.svgdescriptive1
SW_Menu3_3_CLR.svgdescriptive1
SW_Menu3_4_CLR.svgdescriptive1
api-spec-ring.pngdescriptive1
open-source-ring.pngdescriptive1
swaggerhub-ring.pngdescriptive1

See Accessibility tab for detailed alt text quality analysis.

A+
Schema Markup Audit
Per-type completeness vs Schema.org requirements + rich-result eligibility
PASS

No structured data detected

Without JSON-LD or microdata, this page can't qualify for any of Google's rich result formats. Even basic Organization or WebSite schema is a quick win.

Hreflang
0 hreflang tags
INFO
0 hreflang tags

No hreflang tags detected.

Hreflang tags are only needed for multilingual or multi-regional sites.

All checks on this page are automated. Results are estimates - run targeted manual reviews when the score affects a release decision.

Send Feedback