> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shopsniffer.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# PageSpeed audit

Google Lighthouse scores across performance, accessibility, best practices, and SEO for every ShopSniffer report.

## Overview

Every report includes a Google PageSpeed Insights audit of the store's homepage, providing Lighthouse scores across four categories. Use these to benchmark store performance, find optimization wins, or track SEO health over time when combined with monitoring.

## Categories

**Performance**

Core Web Vitals (LCP, FID, CLS), total blocking time, speed index.
  **Accessibility**

Color contrast, alt text, ARIA labels, keyboard navigation.
  **Best practices**

HTTPS, no console errors, safe image aspect ratios.
  **SEO**

Meta descriptions, canonical URLs, mobile-friendly, `robots.txt`.

Scores are returned as floats between 0 and 1 (multiply by 100 for the familiar 0-100 Lighthouse display). Individual audits include numeric values in milliseconds for metrics like largest-contentful-paint and total-blocking-time.

## Accessing audit data

The full audit data is available via `GET /api/pagespeed/:jobId`, returning the raw PageSpeed Insights JSON. See the [reports API](/api/reports#get-pagespeed-jobid) for the full schema.

```bash
curl https://shopsniffer.com/api/pagespeed/a1b2c3d4-e5f6-7890-abcd-ef1234567890
```

```json title="Response"
{
  "data": {
    "lighthouseResult": {
      "categories": {
        "performance": { "score": 0.72 },
        "accessibility": { "score": 0.91 },
        "best-practices": { "score": 0.83 },
        "seo": { "score": 0.95 }
      }
    }
  }
}
```

## Tracking performance over time

Pair PageSpeed audits with [store monitoring](/monitoring) to track how a store's performance evolves across deployments. Every snapshot includes a fresh PageSpeed run, so you can graph LCP, CLS, and category scores over weeks or months.

## Next steps

**[Reports API](/api/reports)**

`GET /api/pagespeed/:jobId` reference.
  **[Monitoring](/monitoring)**

Track PageSpeed scores across daily snapshots.
  **[Lighthouse docs](https://developer.chrome.com/docs/lighthouse)**

Google's authoritative audit reference.
  **[How it works](/how-it-works)**

The audit stage in the pipeline.