Hreflang Validator
Home/Tools/Technical SEO/Hreflang Validator
⚙ Technical SEO

Hreflang Validator

v1.0 documentation

Validates hreflang implementation across multilingual pages. Checks for missing return tags, invalid lang codes, and x-default.

URL inputXLSX export
hreflang_validator.py118 lines3 paramsPython 3.8+
Quick start
1

Install

terminal
pip install -r requirements.txt
2

Run

terminal
python hreflang_validator.py --urls https://example.com/en/ https://example.com/de/
terminal
python hreflang_validator.py --url https://example.com/en/ --output hreflang.xlsx
3

Export

Add --output report.xlsx to save results as a spreadsheet.

Parameters
FlagDescription
--urlSingle URL
--urlsUrls. Multiple values allowed
--outputSave as XLSX
help
python hreflang_validator.py --help
Use cases
Technical audit
Pre-launch check
Ongoing monitoring

Run as part of a full site audit. Export issues to XLSX, prioritize by severity, and create a fix roadmap for the dev team.

Run before launching a new site or after a migration. Catch technical issues before Google crawls the new version.

Schedule regular checks and compare outputs over time. Catch regressions early.

Dependencies

Requires: beautifulsoup4, pandas, requests. All included in requirements.txt.

Get all 154 Python SEO tools — $49

One-time payment. Lifetime access. No monthly fees.
Learn 25 tools and get 25% back. Earn from client work and get 50% back.

Get the full toolkit

AAIO Inc — aaioinc.com/tools/hreflang_validator/