Metrical Digital API
Programmatic access to everything Metrical offers. Run performance audits, retrieve results, and monitor Core Web Vitals directly from your code.
What you'll be able to do
Run scans programmatically
Trigger performance audits from your CI/CD pipeline, scripts, or applications. Get the same thorough analysis you see in the dashboard, via a simple REST API.
Retrieve structured results
Access scan results as structured JSON. Core Web Vitals, performance scores, prioritised recommendations, and plain English explanations. All machine-readable.
Monitor over time
Track performance trends across deploys. Set up scheduled scans and get notified when metrics regress beyond thresholds you define.
Integrate with your tools
Build custom dashboards, feed data into Slack or PagerDuty, or block deploys that fail performance budgets. The API gives you the data and you decide what to do with it.
Designed for developer experience
Simple REST endpoints
No complex SDKs or heavy dependencies. Standard HTTP requests with JSON responses. If you can use fetch, you can use the Metrical API.
API key authentication
Straightforward API key auth. Generate keys from your dashboard, scope them to specific permissions, and rotate them when needed.
Webhooks for async results
Scans take time to run properly. Register a webhook URL and get notified when results are ready. No polling required.
Get notified when it launches
The API is currently in development. If you're interested in early access or have specific use cases you'd like supported, we'd love to hear from you.