# Lightscore

> Free online Google Lighthouse audits from multiple regions, plus a
> Lighthouse API you drive from curl or CI. Launch offering: free for now;
> billing (prepaid credits covering compute + operational costs) may come later.

Audits run Lighthouse 12.8.2 / Chromium 148.0.7778.215
(Mobile · simulated Slow 4G) on dedicated hardware. A job runs from the regions
you select — any of the regions below, up to 2 per run (default:
fra,iad); results per region are independent.

## Endpoints (all GET, no auth)

- POST https://lightscore.dev/report with form fields url, regions, device, format=json —
  start (or reuse) an audit. regions is comma-separated, up to 2
  region ids (default: fra,iad). device is mobile (default) or
  desktop. Returns the run as JSON: id, status, device, per-region
  results, permalink, json_url, status_url. Without format=json it
  redirects to the HTML report. GET /report?url=…&… with the same params
  works too.
- https://lightscore.dev/report/HOST/RUN_ID/status — poll {"status": "queued|running|completed|failed"}.
- https://lightscore.dev/report/HOST/RUN_ID.json — the finished run: per-region scores
  (performance, accessibility, seo, best_practices), Core Web Vitals
  metrics, and signed download URLs for the raw Lighthouse JSON/HTML
  (links expire ~1h; re-fetch this endpoint for fresh ones).
- https://lightscore.dev/api/v1/regions — region catalog as JSON.
- https://lightscore.dev/api/v1/status — live per-region service health (active regions only:
  operational|degraded|down, last verified, typical duration).
- https://lightscore.dev/api/v1/health — service health.

## Regions

- fra: Frankfurt, Germany — active
- iad: Washington, D.C., USA — active
- nrt: Tokyo, Japan — active
- bom: Mumbai, India — coming_soon
- lax: Los Angeles, USA — active
- gru: São Paulo, Brazil — active
- jnb: Johannesburg, South Africa — active
- syd: Sydney, Australia — active

## Limits

- Up to 20 new audits per IP per hour (the per-IP cap loosens while the
  tool is quiet and tightens under load); up to 2 regions per run; mobile
  or desktop device profile; results cached 24h per (URL, region set, device).
- Audits are async; a run typically completes in 30–90 seconds.
- Public http(s) URLs only (no private hosts, IPs, or custom ports).