Google PageSpeed Insights API

Name: PageSpeed Insights API
Brand: PageSpeed Insights API
Availability: InStock

✓ Official Vendor SpecAnalyticsWeb Analyticsoauth21 EndpointsREST

Install Jentic One Beta

Connect the PageSpeed Insights API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the PageSpeed Insights API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with PageSpeed Insights API.

Run a mobile or desktop Lighthouse audit against any public URL

Read Core Web Vitals (LCP, INP, CLS) along with lab and field metrics

Pull category scores for performance, accessibility, best-practices, SEO, and PWA

GET STARTED

Start building with PageSpeed Insights API

Explore with Jentic

View OpenAPI Document

For Agents

Run a Lighthouse-based performance audit on any public URL and read back Core Web Vitals, lab metrics, and optimisation suggestions.

Use for: Audit the homepage performance for mobile users, Get the Largest Contentful Paint for a checkout page, Compare desktop and mobile PageSpeed scores for a URL, Find accessibility issues on a marketing landing page

Not supported: Does not run real-user monitoring, audit authenticated flows, or fix performance issues - use for synthetic Lighthouse audits of public URLs only.

The PageSpeed Insights API runs Lighthouse against any public URL and returns a structured performance report including Core Web Vitals, lab metrics, and optimisation suggestions. It exposes a single runPagespeed endpoint that accepts a URL plus options for strategy (mobile or desktop) and the categories to score (performance, accessibility, best-practices, SEO, PWA). Use it to integrate web performance budgets into CI, build dashboards that track real-user metrics over time, or pull suggestions to feed engineering backlogs. The spec exposes 1 endpoint.

Use Cases

Patterns agents use PageSpeed Insights API for, with concrete tasks.

★ Performance budgets in CI

Run PageSpeed Insights against staging URLs after every deploy and fail the build if the performance score drops below a budget or if a Core Web Vital regresses. The single runPagespeed endpoint returns enough structured data - category scores plus per-audit results - to assert specific thresholds. Pairs naturally with PRs that compare current vs main scores.

Call GET /pagespeedonline/v5/runPagespeed with url=https://staging.example.com and strategy=MOBILE, parse the performance score, and fail the build if it is below 0.85.

Field metrics dashboards

Aggregate Core Web Vitals from PageSpeed Insights - including the CrUX field data - into a dashboard that tracks LCP, INP, and CLS for a portfolio of URLs over time. The structured response makes it cheap to extract metrics on a daily cron without scraping the public PSI page. Useful for content sites, e-commerce, and marketing teams reporting on page experience.

For every URL in homepages.json, call runPagespeed with strategy=MOBILE, extract loadingExperience metrics, and append them to a BigQuery table for trend reporting.

Optimisation suggestion feed for engineering

Pull the audits array from a PageSpeed Insights response to surface actionable recommendations - image format conversion, unused JavaScript, render-blocking resources - and turn them into engineering tickets. Each audit comes with details on the offending elements, byte savings estimates, and links to documentation.

Call runPagespeed for the URL https://example.com/products, extract any audit with score below 0.5 and weighted savings above 100ms, and create a Jira ticket for each.

Agent-driven page health checks via Jentic

A site-reliability agent reacting to a slow-page complaint can use Jentic to call PageSpeed Insights and reply with a precise breakdown of what regressed. Credentials stay in your Jentic One instance, so the agent runs under a scoped key with audit trail. Useful for support bots that need to triage performance complaints automatically.

Use Jentic to find the run-pagespeed operation, load its schema, and execute it for the complained-about URL with strategy=MOBILE, then reply with LCP, INP, and CLS values.

Key Endpoints

1 endpoints — the pagespeed insights api runs lighthouse against any public url and returns a structured performance report including core web vitals, lab metrics, and optimisation suggestions.

METHOD

PATH

DESCRIPTION

GET

/pagespeedonline/v5/runPagespeed

Run a Lighthouse audit against a URL

GET

/pagespeedonline/v5/runPagespeed

Run a Lighthouse audit against a URL

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your PageSpeed Insights credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'audit a page's performance', and Jentic returns the runPagespeed operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using PageSpeed Insights API through Jentic.

What authentication does the PageSpeed Insights API use?

The API supports anonymous use with a basic quota and Google OAuth 2.0 / API key for higher quotas. Through Jentic, the API key is stored encrypted in your Jentic One instance and attached to each request, so agents never see the raw key.

Can I get Core Web Vitals from this API?

Yes. The runPagespeed response includes a loadingExperience field with field-level Core Web Vitals (LCP, INP, CLS) sourced from the Chrome User Experience Report when enough field data is available.

What are the rate limits for the PageSpeed Insights API?

Anonymous calls are limited to a small number of queries per second; with an API key the default is 25,000 queries per day per project. For higher volume, request a quota increase in the Cloud Console rather than retrying on 429.

How do I run an audit through Jentic?

Search Jentic for run pagespeed audit, load the schema for GET /pagespeedonline/v5/runPagespeed, and execute it with the URL, strategy, and category list. Jentic returns the structured Lighthouse report for parsing.

Is the PageSpeed Insights API free?

Yes - the public PSI API is free within the documented quota. You only pay if you wrap it inside another billable Google Cloud product like Cloud Run for orchestration.

Does this API audit pages behind authentication?

No - runPagespeed only reaches public URLs. To audit authenticated flows, run Lighthouse locally with cookies or a service-worker, then use this API only for public benchmarks.

Can I limit what my agent is allowed to do with the PageSpeed Insights API?

Yes. Because you self-host Jentic One, your own rules decide which operations and credentials the agent may use, and the PageSpeed Insights API exposes a single read operation, runPagespeed, so you can restrict the agent to running a synthetic Lighthouse audit of a public URL and nothing else. That read is the only call in the allowed set, so the agent cannot change anything on your Google account or reach any other endpoint. You control the scoping at the operator level, keeping the agent limited to on-demand performance audits.