Lighthouse Checker

Run Google Lighthouse audits on any URL or entire website via sitemap. Get performance, accessibility, SEO, and best practices scores with mobile/desktop emulation.

Features

• Single URL or Batch Processing - Audit one page or hundreds at once
• Sitemap Discovery - Automatically extract URLs from sitemap.xml (supports sitemap indexes and gzipped sitemaps)
• URL Filtering - Filter sitemap URLs with regex patterns
• Device Emulation - Test as mobile or desktop with configurable viewports
• Network Throttling - Simulate slow 3G, fast 3G, or custom network conditions
• Authenticated Pages - Support for cookie injection and automated form login
• Concurrent Processing - Run multiple audits in parallel (up to 5)
• Smart Retries - Automatic retry with third-party resource blocking for flaky pages
• Detailed Reports - Full Lighthouse HTML and JSON reports stored for each URL

Input

Field	Type	Description
url	string	Single URL to audit
urls	string[]	Array of URLs to audit
sitemapUrl	string	Sitemap URL to discover pages from
maxUrls	number	Maximum URLs to audit from sitemap
urlPattern	string	Regex pattern to filter URLs
device	string	mobile or desktop (default: mobile)
categories	string[]	Categories to audit: performance, accessibility, best-practices, seo, pwa
preset	string	quick (perf only, no throttling), full (all categories), default
concurrency	number	Parallel audits (1-5, default: 1)
timeout	number	Timeout in seconds (30-300, default: 60)
cookies	object[]	Session cookies for authenticated pages
login	object	Automated login configuration

Output

Each audited URL produces a dataset item with:

{
  "summary": {
    "url": "https://example.com",
    "finalUrl": "https://example.com/",
    "fetchTime": "2024-01-15T10:30:00.000Z",
    "scores": {
      "performance": 85,
      "accessibility": 92,
      "bestPractices": 100,
      "seo": 90,
      "pwa": null
    },
    "coreWebVitals": {
      "lcp": 1250,
      "cls": 0.05,
      "fcp": 800,
      "ttfb": 320,
      "inp": null
    }
  },
  "artifacts": {
    "htmlReportUrl": "https://api.apify.com/v2/key-value-stores/.../records/report-example-com.html",
    "jsonReportUrl": "https://api.apify.com/v2/key-value-stores/.../records/report-example-com.json",
    "screenshotUrl": "https://api.apify.com/v2/key-value-stores/.../records/screenshot-example-com.jpg"
  }
}

Examples

Single URL

{
  "url": "https://example.com",
  "device": "mobile",
  "categories": ["performance", "accessibility"]
}

Batch from Sitemap

{
  "sitemapUrl": "https://example.com/sitemap.xml",
  "maxUrls": 100,
  "urlPattern": "/blog/",
  "device": "desktop",
  "categories": ["performance", "seo"],
  "concurrency": 3
}

Quick Performance Check

{
  "urls": [
    "https://example.com",
    "https://example.com/about",
    "https://example.com/contact"
  ],
  "preset": "quick",
  "concurrency": 3
}

Authenticated Pages (Cookies)

{
  "url": "https://example.com/dashboard",
  "cookies": [
    {
      "name": "session_id",
      "value": "abc123",
      "domain": "example.com"
    }
  ]
}

Authenticated Pages (Login Flow)

{
  "url": "https://example.com/dashboard",
  "login": {
    "loginUrl": "https://example.com/login",
    "usernameSelector": "#email",
    "passwordSelector": "#password",
    "submitSelector": "button[type='submit']",
    "username": "user@example.com",
    "password": "your-password"
  }
}

Key-Value Store Output

In addition to the dataset, the actor stores:

• summary.json - Aggregate statistics for the batch
• report-{slug}.html - Interactive Lighthouse HTML report for each URL
• report-{slug}.json - Full Lighthouse JSON report for each URL
• screenshot-{slug}.jpg - Final rendered screenshot for each URL

Use Cases

• Monitor Core Web Vitals across your entire site
• Track accessibility compliance at scale
• Compare mobile vs desktop performance
• Audit authenticated/logged-in pages
• Integrate Lighthouse into CI/CD pipelines via Apify API
• Generate performance reports for clients

Limitations

• Maximum 5 concurrent audits (Chrome is resource-intensive)
• Timeout range: 30-300 seconds per audit
• Some sites may block automated browsers

Resources

• Google Lighthouse Documentation
• Core Web Vitals
• Apify Platform Documentation