Catalog Image Checker — Broken Links & Dimensions

Audit images discovered in public catalog HTML or supplied directly. Detect HTTP failures, non-image responses, small dimensions, and unknown formats. Probe at most 512 KB per image and report JPEG, PNG, GIF, or WebP dimensions without bulk downloads.

Quick start

Try the small public demonstration fixture first, then replace its URL with your own public source:

{
  "urls": [
    "https://commerce-actor-demos.vercel.app/product.html"
  ],
  "maxResults": 10
}

The demo source contains synthetic catalog data labelled as a test fixture. Results go straight into the default Dataset. Export JSON, CSV, or Excel in Apify Console. Diagnostics are saved as RUN_STATS.

What it does

Reads img src, data-src, data-original, srcset/data-srcset, and Open Graph image metadata. Sends a source Referer and a bounded Range probe. JPEG, PNG, GIF, and common WebP headers provide dimensions; SVG, AVIF, and a JPEG header beyond the probe remain dimensions unknown. HTTP status and MIME checks are reported even when dimensions are unavailable. Byte size is unknown when the server does not provide a trustworthy total. Does not run JavaScript, decode full images, extract CSS backgrounds, compare visual quality, or rehost images.

Output

Main dataset fields: imageUrl, healthy, httpStatus, format, width, height, byteSize, issues, sourceUrl. A stable recordKey is included for retry deduplication. Inspect the demo run's dataset for a complete working output example.

Verified demo output

This sample was returned by a successful cloud run against the public synthetic fixture.

[
  {
    "sourceUrl": "https://commerce-actor-demos.vercel.app/product.html",
    "imageUrl": "https://commerce-actor-demos.vercel.app/sample.png",
    "alt": "Synthetic demo catalog image",
    "finalUrl": "https://commerce-actor-demos.vercel.app/sample.png",
    "httpStatus": 206,
    "contentType": "image/png",
    "format": "png",
    "width": 640,
    "height": 640,
    "byteSize": 7259,
    "probeBytes": 7259,
    "probeTruncated": false,
    "issues": [],
    "healthy": true
  }
]

Pricing

Configured launch price: $2.00 per 1,000 image records, plus a $0.00005 Actor-start event (memory-based, minimum one event). Check the live Pricing tab before running; discounted tiers may differ. Platform usage is included in pay-per-event pricing. Each dataset record is one event, including a validation result that reports issues. RUN_STATS diagnostics are not dataset items. Spending-limit checks stop new work before the next record.

Limits and honest failures

Default maxResults is 100. This is a preview cap, not a promise to export everything. Set a larger cap only after checking a sample. Up to 100 source URLs, 8 MB per document, 50,000 rows per feed, 30-second request timeouts, 512 KB image probes, conservative shared request spacing, and at most five redirects. Public HTTP(S) only. Private/reserved addresses and credential URLs are rejected; DNS destinations are checked and pinned. robots.txt is respected. 429/503 stops the source for a later retry. Login/CAPTCHA pages, browser-only markup, and denied requests are reported rather than bypassed.

All-source failure ends FAILED after saving diagnostics. Useful partial output remains available with a partial status. Truncation and spending-limit stops are marked separately. Migration/retry checkpoints and existing dataset record IDs prevent repeated output in the same run. New independent runs are charged normally.

Input

• urls: 1–100 public HTTP(S) URLs. No credentials, private networks, custom ports, or access-control bypass.
• maxResults: Global output cap. RUN_STATS reports truncation. Start with a small sample. Default: 100.
• requestDelayMs: Shared host spacing. Requests stop on 429/503 instead of ignoring cooldowns. Default: 500.
• directImages: Input URLs are image files. Default: false.
• minWidth: Minimum width. Default: 600.
• minHeight: Minimum height. Default: 600.

API

Use your Apify token in the Authorization header. For small jobs:

curl -X POST \
  'https://api.apify.com/v2/acts/skyfishdev~catalog-image-health-checker/run-sync-get-dataset-items' \
  -H 'Authorization: Bearer YOUR_APIFY_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"urls":["https://commerce-actor-demos.vercel.app/product.html"],"maxResults":10}'

For larger jobs, use the asynchronous runs endpoint, poll the run status, and fetch its default dataset.

Local development

npm ci
npm test
apify run --input-file examples/demo.json

No LLM bill, image-host subscription, or additional API key is required. Only process public sources you are authorized to use. This tool does not promise customer demand, Google approval, or complete data on every website.