Hreflang Cluster Auditor

Store Positioning

Store title: Hreflang Cluster Auditor

Short description: Audit hreflang clusters, language and region codes, reciprocal return links, x-default coverage, and canonical conflicts.

SEO title: Hreflang Cluster Auditor — technical SEO, web, and domain audit

SEO description: Audit hreflang clusters, language and region codes, reciprocal return links, x-default coverage, and canonical conflicts. Use it to find crawlability, indexability, security, metadata, and page-quality issues with evidence-backed rows and audit reports.

Categories: SEO_TOOLS, ECOMMERCE

Keywords: hreflang, cluster, auditor, web/domain audit

Pay-Per-Event Pricing

This actor uses pay-per-event pricing. Event prices include Apify platform usage; users are not expected to pay a separate platform-usage pass-through charge for the configured pricing model.

• Tier: W1 — Web/domain audit
• Primary event: page-audited at $0.00490 base
• Default max charge: $10.00
• Store discounts: FREE/BRONZE base, SILVER discounted, GOLD deepest approved discount

Event set:

• actor-start: base $0.00500, GOLD $0.00400. Hreflang Cluster Auditor: charged when actor start is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• page-audited: base $0.00490, GOLD $0.00392. Hreflang Cluster Auditor: charged when page audited is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• rule-parsed: base $0.00372, GOLD $0.00298. Hreflang Cluster Auditor: charged when rule parsed is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• finding-emitted: base $0.00372, GOLD $0.00298. Hreflang Cluster Auditor: charged when finding emitted is completed. The price includes Apify platform usage; no separate usage pass-through is intended.
• audit-report-generated: base $0.05000, GOLD $0.04000. Hreflang Cluster Auditor: charged when audit report generated is completed. The price includes Apify platform usage; no separate usage pass-through is intended.

Public Task Concepts

• Audit Hreflang Cluster controls on a capped public sample
• Find high-priority Hreflang Cluster issues before release
• Validate Hreflang Cluster evidence from supplied pages
• Prioritize Hreflang Cluster fixes with severity and proof
• Export Hreflang Cluster QA rows for client review

Audit hreflang clusters, language and region codes, reciprocal return links, x-default coverage, and canonical conflicts.

Inputs

This actor accepts the locked fields for actor 255: startUrls, sitemapUrls, htmlInputs, allowedDomains, maxPages, maxDepth, validateReturnLinks, checkAlternateStatus, requireSelfReference, requireXDefault, includeSitemapAlternates, requestDelayMs, timeoutMs. URL and sitemap inputs use production fetch paths; supplied HTML, JSON, header, or XML records are offline inputs for controlled runs.

Output

Dataset rows use the approved fields: sourceUrl, canonicalUrl, hreflang, alternateUrl, alternateStatus, clusterId, clusterSize, languageCodeValid, regionCodeValid, hasSelfReference, hasReturnLink, xDefaultPresent, duplicateLanguageTarget, canonicalConflict, issueCode, severity, recommendation. The actor also writes these local report artifacts: hreflang-cluster-audit.md, hreflang-page-results.csv, hreflang-clusters.json, missing-return-links.csv, invalid-hreflang-codes.csv, x-default-coverage.json.

Public source provenance

Bounded reciprocal hreflang snapshot from https://www.apple.com/ and https://www.apple.com/fr/, observed 2026-07-12. Both pages published en-US and fr-FR alternates; the bounded pair did not include x-default.

Local run

npm test
APIFY_LOCAL_STORAGE_DIR=storage CRAWLEE_STORAGE_DIR=storage npm run smoke

Billing and cost controls

This actor uses pay-per-event pricing. It charges actor-start, then page-audited before each dataset row, and audit-report-generated before report artifacts. maxChargeUsd is enforced locally and in Apify runs; when the limit is reached, uncharged rows and reports are withheld. Platform usage pass-through remains off.