Hreflang Checker + Canonical Checker: Bulk International SEO
Pricing
from $1.17 / 1,000 url checkeds
Hreflang Checker + Canonical Checker: Bulk International SEO
Bulk hreflang checker and canonical checker: validates language codes, return tags, x-default, self-reference, canonical target and noindex for every URL or sitemap. No login.
Pricing
from $1.17 / 1,000 url checkeds
Rating
0.0
(0)
Developer
Detroit Web Agent - Open Data
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Features
Share
Hreflang checker and canonical checker for international SEO audits, in bulk. Paste page links or a sitemap and get one row per URL with the canonical, every hreflang entry, and a plain list of what is wrong: invalid language codes, missing return tags, no x-default, no self-reference, canonical pointing somewhere else, broken or redirecting alternates, and noindex pages that make the whole set useless.
It fetches each page over plain HTTP, reads the tags from the HTML head and from the HTTP Link header, then opens every alternate page to confirm it links back. No login, no browser, no proxy and no API key.
Run in 30 seconds
- Open the Input tab. The prefilled list checks 13 well-known multilingual sites.
- Click Start. It finishes in under a minute.
- Open the Results table in the Output tab, or export the dataset as JSON, CSV or Excel.
- Replace the list with your own URLs, or paste a
sitemap.xmllink, and run again.
What does this Actor do?
International sites break in quiet ways. A single missing return tag makes Google ignore a language version. A canonical that points to a different page tells search engines your page is a duplicate. A en_GB typed with an underscore is silently dropped. This Actor finds those problems on every URL you give it and says exactly what to fix.
For each page it reports:
- Canonical: the URL, where it was declared (HTML, HTTP header or both), whether it is self-referencing, absolute, declared once, inside the head, and whether the target returns 200 without redirecting or being noindex.
- Hreflang set: every
rel="alternate" hreflangentry from the HTML, theLinkheader, or the sitemap, with a validity flag and reason for each code. - Return tags: whether each alternate links back to the page (reciprocal annotations, the most common reason hreflang is ignored).
- x-default and self-reference: present or missing.
- Alternate health: HTTP status of each alternate, redirects, and noindex.
- Page signals: HTTP status, redirect hops, noindex from meta robots or
X-Robots-Tag,html lang, title. - Issues: a plain-English list plus an
issueCountand anokflag, so you can filter a thousand URLs down to the broken ones.
What is checked
| Check | What it catches |
|---|---|
| Code validity | Underscores (en_GB), UK instead of GB, country code without a language, unknown languages, UN M.49 numbers, bad scripts |
| Return tags | Alternate pages that do not link back (reciprocal hreflang) |
| Self-reference | Page missing from its own hreflang set |
| x-default | No fallback entry |
| Duplicate languages | The same language pointing to two different URLs |
| Alternate status | 404, 5xx, unreachable, redirecting or noindex alternates |
| Canonical | Missing, duplicated, conflicting, relative, outside head, pointing elsewhere, broken target |
| Conflict | Hreflang placed on a page whose canonical points to another URL |
| Page | HTTP errors, redirect chains, noindex, html lang that does not match hreflang |
Limits
- It reads the server HTML. Tags that only appear after JavaScript runs are not seen, which matches what many crawlers see first. Sites that inject hreflang client-side will show as having none.
- Sites that block datacenter traffic (HTTP 403, 429 or 5xx) cannot be read. Those URLs are listed in the run
OUTPUTand the row is not charged. - Very large hreflang sets are capped by Max alternates per page (default 40). The page itself and x-default are always verified first, and a note is added when entries were skipped.
- Gzipped sitemaps are not unpacked; give the plain
sitemap.xml.
Input
| Field | Meaning |
|---|---|
urls | Full page links, one per line. A bare domain like example.com/page also works. |
sitemapUrl | Optional sitemap.xml or sitemap index. Its pages are added to the list. Hreflang written in the sitemap is used when a page has none in its HTML. |
maxUrls | Upper limit on pages checked (default 100, max 5000). |
checkReturnTags | Fetch each alternate and confirm it links back (default on). |
checkCanonicalTarget | Fetch a canonical that points elsewhere and check it (default on). |
maxAlternatesPerPage | Cap on alternates verified per page (default 40). |
Example input
{"urls": ["https://www.example.com/en/","https://www.example.com/de/","https://www.example.com/fr/pricing"],"checkReturnTags": true}
Sitemap input:
{ "sitemapUrl": "https://www.example.com/sitemap.xml", "maxUrls": 200 }
Output sample
{"url": "https://www.example.com/en/","finalUrl": "https://www.example.com/en/","statusCode": 200,"canonical": "https://www.example.com/en/","canonicalSource": "html","canonicalOk": true,"hreflangCount": 3,"hreflangs": [{ "lang": "en", "href": "https://www.example.com/en/", "source": "html", "valid": true, "isSelf": true, "status": null, "returnTag": null },{ "lang": "de", "href": "https://www.example.com/de/", "source": "html", "valid": true, "isSelf": false, "status": 200, "returnTag": false },{ "lang": "en_GB", "href": "https://www.example.com/gb/", "source": "html", "valid": false, "reason": "uses an underscore, hreflang needs a hyphen (en-GB, not en_GB)" }],"hasSelfReference": true,"hasXDefault": false,"invalidCodes": ["en_GB: uses an underscore, hreflang needs a hyphen (en-GB, not en_GB)"],"missingReturnTags": ["https://www.example.com/de/"],"noindex": false,"issues": ["no x-default hreflang","invalid hreflang code en_GB: uses an underscore, hreflang needs a hyphen (en-GB, not en_GB)","missing return tag: https://www.example.com/de/ does not link back to this page"],"issueCount": 3,"ok": false}
The run also stores an OUTPUT record with totals: URLs checked, clean, with issues, unreachable, and any not checked because of the time limit or your cost cap.
Use cases
- International SEO audits: check every market page before a launch or migration.
- Migrations and relaunches: confirm hreflang and canonicals survived a URL change.
- Agencies: run the same list for each client every month and compare issue counts.
- Monitoring: schedule a weekly run on key pages and alert when
okturns false. - QA before release: validate language codes and return tags for new locales.
- Content and localisation teams: find language versions that exist but are not wired together.
Pricing
Pay per event, no subscription. Current prices:
| Event | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Actor Start | $0.00005 | $0.00005 | $0.00005 | $0.00005 | $0.00005 | $0.00005 |
| URL checked | $0.0019 | $0.00177 | $0.001509 | $0.001167 | $0.001167 | $0.001167 |
Tier follows your Apify subscription plan.
Apify's free plan includes monthly platform credit that covers test runs.
Examples at the current price (one url-checked event per result; Free-plan tier):
| You pull | You pay |
|---|---|
| 100 results | $0.19 |
| 1,000 results | $1.90 |
| 10,000 results | $19.00 |
Scheduled runs stay cheap when each run only returns new records.
Integrations and scheduling
Run it on a schedule, then send results to Google Sheets, Slack, email, Make, Zapier or n8n with the Apify integrations, or call it through the REST API and the Python and JavaScript clients. Filter the dataset on ok = false to build an alert.
Use with the API, n8n, Make, Zapier or AI agents
API (one call, returns the rows as JSON):
curl -X POST "https://api.apify.com/v2/acts/transparent_meteorite~hreflang-canonical-checker/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \-H "Content-Type: application/json" \-d '{"urls":["https://www.example.com/en/","https://www.example.com/de/"]}'
Python
from apify_client import ApifyClientclient = ApifyClient("YOUR_APIFY_TOKEN")run = client.actor("transparent_meteorite/hreflang-canonical-checker").call(run_input={"urls": ["https://www.example.com/en/"]})for row in client.dataset(run["defaultDatasetId"]).iterate_items():if not row["ok"]:print(row["url"], row["issues"])
- n8n, Make, Zapier: use the Apify app's "Run Actor" step with actor
transparent_meteorite/hreflang-canonical-checker, paste the input JSON, then map the dataset items to your sheet. - AI agents (MCP): connect the Apify MCP server at
https://mcp.apify.com?tools=transparent_meteorite/hreflang-canonical-checkerto Claude, Cursor or any MCP client, and your agent can audit hreflang as a tool.
Fair use and legal
The Actor requests public web pages the same way a search engine crawler does, with a normal user agent and low concurrency. Only check sites you are allowed to audit and respect each site's terms and robots rules. This is an independent tool and is not affiliated with Google or any website it checks.
FAQ
Do I need an API key or a login? No.
What does "missing return tag" mean? Page A lists page B as an alternate, but page B does not list page A. Google needs both directions, otherwise it ignores the annotation. The Actor fetches every alternate to test this.
Which hreflang formats are read? HTML link tags, the HTTP Link header, and xhtml:link entries in a sitemap you provide. Sitemap entries are used only when the page has none of its own.
Does it check x-default? Yes. It reports when x-default is missing. It does not force you to have one, since some sites choose not to.
Why is my URL listed as not charged? The site answered with a block (403 or 429), a server error, or no HTML. The row explains why.
Why did the URL show a redirect issue? The URL you gave redirects to another one. The Actor follows it and checks the final page, but flags it because hreflang and sitemaps should list final URLs.
Can it check thousands of URLs? Yes. Set Max URLs up to 5000, or run several batches. Each run stops cleanly before its time limit and lists unchecked URLs so you can resume.
Does it run JavaScript? No. It reads the server HTML, which is what most crawlers see first.
How do I only see the broken pages? Filter the dataset on ok = false, or sort by issueCount.
Support
Found a site that reads wrongly? Open an issue on the Issues tab with the run URL and the page link.
Related actors
- Technical SEO Page Audit for titles, headings, meta tags and on-page checks on the same URLs.
- Sitemap Link Inventory to list every URL in a sitemap before you check it.
- Website Tech Stack Detector to see which CMS or platform produces the tags.
Changelog
- 0.1: First private build. Canonical and hreflang checks, return-tag verification, sitemap input, Link header support.