List all websites being monitored by Pulspeed. Returns site names, URLs, scan frequency, and strategy.

Trigger a PageSpeed Insights scan for a website URL. Creates the site if not already tracked. By default waits for the scan to complete and returns performance metrics (30-60 seconds). Set wait=false to dispatch asynchronously and get a job_id for polling.

Get performance metrics for a monitored website, including Core Web Vitals (FCP, LCP, TTI, TBT, TTFB, CLS), trend analysis, and historical data over a specified period.

Get AI-powered performance recommendations for a monitored website. Requires Pro or Team plan.

Compare two performance snapshots for a website. Shows metric deltas with percentage changes and a human-readable assessment. By default compares the latest two snapshots, or specify snapshot IDs.

Get current API usage statistics: how many scans and AI analyses have been used this month, remaining quota, and plan limits.

Set performance budget thresholds for a site. When a scan violates these thresholds, webhook events (threshold.exceeded, performance.regression) will fire. Pass null to remove all budgets.

Scan multiple URLs at once. By default runs scans asynchronously and returns job IDs for polling. Set wait=true to run sequentially and return all results (slower, may take several minutes).

Show recent performance regressions for a site: consecutive scans where the performance score dropped significantly. Helps identify when and by how much the site degraded.

Get the raw Lighthouse audit data for a specific audit key from the latest snapshot of a site (e.g. 'render-blocking-resources', 'bootup-time', 'unused-javascript'). Returns detailed audit items useful for debugging specific performance issues.