🚦 Google Lighthouse Audit

Run Google Lighthouse audits for a single URL using Apify.

This actor generates performance, accessibility, best practices, and SEO reports with optional HTML, JSON, and CSV outputs.

Designed to be simple, fast, and public-friendly.

✨ Features

• ✅ Single-URL Lighthouse audit
• 📱 Mobile or Desktop testing
• 📊 Select Lighthouse categories
• 🌐 Configurable throttling method
• 📁 Optional HTML, JSON, and CSV reports
• 📦 Structured summary dataset (scores + Core Web Vitals)
• 🧼 Clean output links in Apify UI

🧩 What this actor does

1. Launches Chrome
2. Runs Google Lighthouse against the provided URL
3. Collects:
   • Lighthouse scores
   • Core Web Vitals
   • Timing metrics
4. Saves selected reports to actor storage
5. Pushes a summary item to the default dataset

▶️ How to use

1. Open the actor
2. Enter the URL you want to audit
3. Choose device, categories, and throttling
4. Select which reports to save
5. Run the actor

🧾 Input configuration

Required

Field	Description
url	Fully qualified URL including protocol (https://)

Optional settings

Device

Option	Description
mobile	Emulates mobile device (default)
desktop	Emulates desktop device

Categories

Select which Lighthouse categories to run:

• performance
• accessibility
• best-practices
• seo

Default: ["performance"]

Throttling

Controls how network conditions are applied:

Value	Description
simulate	Lighthouse simulated throttling (default, recommended)
provided	Use real network conditions
devtools	DevTools network throttling

Report options

Toggle which reports should be generated:

Option	Description	Default
saveHtmlReport	Full interactive Lighthouse HTML report	❌ false
saveJsonReport	Complete Lighthouse JSON output	✅ true
saveCsvReport	CSV summary of scores & metrics	❌ false

📤 Output

📁 Key-Value Store

Depending on selected options, the actor may save:

• report.html – Lighthouse HTML report
• report.json – Full Lighthouse JSON
• report.csv – CSV summary
• summary.json – Structured summary (always saved)

📊 Dataset output (summary)

{
    "url": "https://example.com/",
    "finalUrl": "https://example.com/",
    "device": "mobile",
    "lighthouseVersion": "13.0.1",
    "throttling": "simulate",
    "scores": {
        "performance": 100,
        "accessibility": 96,
        "bestPractices": 92,
        "seo": 80
    },
    "coreWebVitals": {
        "FCP": 802.97,
        "LCP": 802.97,
        "TBT": 0,
        "CLS": 0,
        "SI": 802.97
    },
    "timings": {
        "total": 5298.67
    }
}

This makes the actor ideal for:

• Dashboards
• Monitoring
• CI/CD
• SEO tooling

🧠 Notes & limitations

• 🚫 This actor audits one URL per run
• 🌍 No proxy / geo testing (by design, for simplicity)
• 🔁 Scores may vary slightly between runs due to Lighthouse behavior

🛠️ Use cases

• Website performance checks
• SEO audits
• Core Web Vitals monitoring
• Regression testing
• Automated reporting