Google Lighthouse Checker

Comprehensive web performance analysis tool powered by Google Lighthouse. Evaluate your website's performance, accessibility, SEO, and best practices with customizable scoring thresholds and multiple output formats.

Features

Core Capabilities

• Multi-Device Testing: Run audits on mobile, desktop, or both device types simultaneously
• Comprehensive Analysis: Evaluate performance, accessibility, best practices, and SEO
• Customizable Score Ranges: Define your own thresholds for excellent, good, and poor scores
• Multiple Output Formats: Generate results as tables, graphs, and charts
• Flexible Timeout Settings: Configure evaluation timeouts from 30 to 300 seconds
• Improvement Suggestions: Optional detailed recommendations for performance optimization

Lighthouse Categories

The actor supports four key Lighthouse audit categories:

1. Performance - Page load speed, rendering metrics, and resource optimization
2. Accessibility - WCAG compliance and usability for users with disabilities
3. Best Practices - Modern web development standards and security
4. SEO - Search engine optimization and discoverability

Input Configuration

Required Parameters

• url (string, required): The URL of the website to audit
  • Example: https://apify.com

Optional Parameters

• apiKey (string, optional): API key for authentication if required

• outputFormats (array, optional): Output format preferences

  • Options: table, graphs, charts
  • Default: ["table"]

• evaluationTimeoutInSeconds (integer, optional): Maximum time for Lighthouse evaluation

  • Range: 30-300 seconds
  • Default: 100

• deviceType (string, optional): Device type for audit simulation

  • Options: mobile, desktop, both
  • Default: "desktop"

• lighthouseCategories (array, optional): Categories to evaluate

  • Options: performance, accessibility, best-practices, seo
  • Default: All categories

• includeImprovements (boolean, optional): Include improvement suggestions

  • Default: false

• scoreRanges (object, optional): Custom score thresholds for each category

  • Each category must have: excellent, good, poor (0-100)
  • Must satisfy: excellent >= good >= poor
  • Default ranges: excellent ≥ 90, good ≥ 50, poor ≥ 0

Sample Input

Basic Usage

{
  "url": "https://example.com",
  "deviceType": "desktop",
  "outputFormats": ["table"]
}

Advanced Configuration

{
  "url": "https://apify.com/ideas/google-lighthouse-checker-44d82046",
  "apiKey": "",
  "outputFormats": ["table", "charts", "graphs"],
  "evaluationTimeoutInSeconds": 100,
  "deviceType": "desktop",
  "lighthouseCategories": ["performance", "accessibility", "best-practices", "seo"],
  "includeImprovements": true,
  "scoreRanges": {
    "performance": {
      "excellent": 90,
      "good": 50,
      "poor": 0
    },
    "accessibility": {
      "excellent": 90,
      "good": 50,
      "poor": 0
    },
    "best-practices": {
      "excellent": 90,
      "good": 50,
      "poor": 0
    },
    "seo": {
      "excellent": 90,
      "good": 50,
      "poor": 0
    }
  }
}

Multi-Device Testing

{
  "url": "https://example.com",
  "deviceType": "both",
  "outputFormats": ["table", "graphs"],
  "lighthouseCategories": ["performance", "seo"]
}

Custom Score Thresholds

{
  "url": "https://example.com",
  "deviceType": "mobile",
  "scoreRanges": {
    "performance": {
      "excellent": 95,
      "good": 70,
      "poor": 0
    },
    "accessibility": {
      "excellent": 100,
      "good": 80,
      "poor": 0
    }
  }
}

Output Structure

The actor returns a structured output with the following fields:

{
  "success": boolean,
  "report": string,
  "message": string,
  "executionTimeInMs": number
}

• success: Indicates whether the audit completed successfully
• report: Formatted report based on selected output formats
• message: Status message or error details
• executionTimeInMs: Total execution time of the audit

Score Interpretation

Default Score Ranges

Category	Excellent	Good	Poor
All	≥ 90	50-89	0-49

Custom Score Ranges

You can customize score thresholds for each category independently. This is useful for:

• Setting stricter standards for critical metrics
• Adjusting thresholds based on industry benchmarks
• Creating custom performance targets aligned with business goals

Validation Rules:

• All scores must be between 0-100
• excellent must be ≥ good
• good must be ≥ poor

Use Cases

Web Development

• Pre-deployment performance checks
• Continuous integration testing
• Performance regression detection

SEO Optimization

• Technical SEO audits
• Mobile-friendliness testing
• Core Web Vitals monitoring

Accessibility Compliance

• WCAG compliance verification
• Accessibility issue identification
• Regular accessibility audits

Competitive Analysis

• Benchmark against competitors
• Industry standard comparison
• Performance gap analysis

Best Practices

1. Timeout Configuration: For complex sites, increase timeout to 150-200 seconds
2. Device Testing: Always test both mobile and desktop for responsive sites
3. Regular Audits: Schedule periodic audits to track performance trends
4. Score Ranges: Adjust thresholds based on your site's baseline performance
5. Categories: Focus on relevant categories for your specific use case

Error Handling

The actor includes robust validation for:

• Invalid URLs
• Malformed score ranges
• Unsupported categories
• Timeout issues

Invalid configurations are automatically corrected with warnings logged to the console.

Limitations

• Maximum evaluation timeout: 300 seconds
• Supported categories: performance, accessibility, best-practices, seo only
• Score ranges must follow logical ordering (excellent ≥ good ≥ poor)

Support

For issues, feature requests, or questions:

• Check the Apify documentation
• Review Lighthouse documentation at web.dev
• Contact support through Apify platform

Version History

Latest Version

• Multi-device testing support
• Customizable score ranges
• Multiple output format options
• Enhanced validation and error handling

---

Note: This actor uses Google Lighthouse under the hood. Results may vary based on network conditions, server response times, and other environmental factors. For consistent results, run multiple audits and average the scores.