Hreflang Checker + Canonical Checker: Bulk International SEO avatar

Hreflang Checker + Canonical Checker: Bulk International SEO

Pricing

from $1.17 / 1,000 url checkeds

Go to Apify Store
Hreflang Checker + Canonical Checker: Bulk International SEO

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

Detroit Web Agent - Open Data

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Features

Limited permissions

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

  1. Open the Input tab. The prefilled list checks 13 well-known multilingual sites.
  2. Click Start. It finishes in under a minute.
  3. Open the Results table in the Output tab, or export the dataset as JSON, CSV or Excel.
  4. Replace the list with your own URLs, or paste a sitemap.xml link, 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" hreflang entry from the HTML, the Link header, 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 issueCount and an ok flag, so you can filter a thousand URLs down to the broken ones.

What is checked

CheckWhat it catches
Code validityUnderscores (en_GB), UK instead of GB, country code without a language, unknown languages, UN M.49 numbers, bad scripts
Return tagsAlternate pages that do not link back (reciprocal hreflang)
Self-referencePage missing from its own hreflang set
x-defaultNo fallback entry
Duplicate languagesThe same language pointing to two different URLs
Alternate status404, 5xx, unreachable, redirecting or noindex alternates
CanonicalMissing, duplicated, conflicting, relative, outside head, pointing elsewhere, broken target
ConflictHreflang placed on a page whose canonical points to another URL
PageHTTP 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 OUTPUT and 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

FieldMeaning
urlsFull page links, one per line. A bare domain like example.com/page also works.
sitemapUrlOptional 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.
maxUrlsUpper limit on pages checked (default 100, max 5000).
checkReturnTagsFetch each alternate and confirm it links back (default on).
checkCanonicalTargetFetch a canonical that points elsewhere and check it (default on).
maxAlternatesPerPageCap 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 ok turns 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:

EventFreeBronzeSilverGoldPlatinumDiamond
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 pullYou 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 ApifyClient
client = 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-checker to Claude, Cursor or any MCP client, and your agent can audit hreflang as a tool.

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.

Changelog

  • 0.1: First private build. Canonical and hreflang checks, return-tag verification, sitemap input, Link header support.