Broken Link & Asset Checker

Check public HTML pages for broken links, images, scripts, and stylesheets before a content publish or website release. Each Dataset record gives the source page status, broken-target evidence, a pass/needs-attention verdict, and a concrete next action.

Best for

• Release QA for landing pages, documentation, and campaign pages
• Content migrations where old assets or internal links may have been removed
• Scheduled checks of a small, known set of critical public pages

Start with the ready-made release check

Use the public Check Website Links & Assets Before Release task when you want a prefilled, bounded check before a launch. It checks one public page, keeps external-target checks off, and caps the run at 10 discovered targets. Duplicate the task, replace the page URL, and run it from the Apify Console.

Input

{
  "startUrls": [{ "url": "https://example.com/" }],
  "includeExternalLinks": false,
  "maxTargetsPerPage": 50,
  "requestTimeoutSecs": 15
}

By default, the Actor checks only same-host targets. Turn on includeExternalLinks when your release QA should also test outgoing links. Set a lower target cap for a fast smoke test.

Output

• verdict: "pass": all checked targets returned a successful or redirect HTTP response.
• verdict: "needs-attention": brokenTargets identifies each target URL, kind, status or request error, and a repair action.
• verdict: "source-unreachable": the source page could not be checked. The diagnostic is stored, but it is not billed.

Pricing

• From $0.03 per completed source-page audit (Free-tier price; eligible higher tiers receive a progressive Store discount)
• A page is charged only after its reachable audit result is written to the default Dataset.
• Source-page access failures are stored as uncharged diagnostics.

For example, checking 100 reachable pages costs up to $3.00 at the Free-tier price. Use the maximum charge setting in Apify to cap a run before it starts.

Automate it

Run the Actor from a deployment script, CI job, or any Apify integration. Keep the token outside source control and pass it as an environment variable:

curl -X POST "https://api.apify.com/v2/acts/x2ppi~website-broken-link-asset-checker/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"startUrls":[{"url":"https://www.example.com/release-page"}],"includeExternalLinks":false,"maxTargetsPerPage":50}'

For recurring checks, save the input as an Apify task and attach a schedule or webhook in the Console. Treat needs-attention results as a release gate: fix each listed target or document why it is intentionally unavailable.

Safety and boundaries

The Actor performs bounded public HTTP checks only: it rejects local and non-public network destinations, validates redirect destinations again, follows at most five redirects, reads at most 2 MiB for each source page, and checks at most 100 discovered targets per page. It does not authenticate, bypass access controls, use a proxy, or confirm SEO rankings, accessibility compliance, or full-site crawl coverage.