# PageSpeed Insights Bulk: Core Web Vitals for many URLs (`steadydata/pagespeed-insights-bulk`) Actor Core Web Vitals and Lighthouse scores for up to 300 URLs per run, from Google's own PageSpeed Insights API. Every row pairs the field data real Chrome users produced over 28 days (LCP, INP, CLS) with the lab scores and the heaviest fixes Lighthouse found. Bring your own free Google key. Pay per URL. - **URL**: https://apify.com/steadydata/pagespeed-insights-bulk.md - **Developed by:** [Steadydata Team](https://apify.com/steadydata) (community) - **Categories:** SEO tools, Developer tools, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.40 / 1,000 url auditeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## PageSpeed Insights Bulk: Core Web Vitals for many URLs Core Web Vitals and Lighthouse scores for up to 300 URLs per run, straight from Google's own PageSpeed Insights API. Every row pairs the field data real Chrome users produced over the last 28 days with the lab scores and the heaviest fixes Lighthouse found. You bring your own free Google API key. That is a deliberate choice, not a missing feature: the key stays yours, the quota stays yours, and nobody sits between you and Google. ### Two kinds of numbers, and the difference matters **Field data** (`field...` columns) comes from the Chrome User Experience Report: what real visitors experienced over 28 days. This is what Google ranks on. A page with too little traffic has no field data, and then `originOverall` still tells you how the domain as a whole is doing. **Lab data** (`lab...` columns and the four scores) is a single measurement in a simulated phone, made right now. Always present, good for diagnosis, not what you are ranked on. A page can score 45 in the lab and still pass Core Web Vitals in the field. Both columns are in every row so you can see that for yourself. ### Getting a key (free, about two minutes) 1. Open the Google Cloud console and pick or create a project. 2. In **APIs & Services > Library**, search for **PageSpeed Insights API** and enable it. 3. In **Credentials**, choose **Create credentials > API key**. 4. Restrict the key to the PageSpeed Insights API. It then cannot be used for anything else. 5. Paste it into the `apiKey` field. The field is stored encrypted by Apify. Google's free quota is generous for this kind of work. If you run out, the run returns `QUOTA_EXCEEDED` rows instead of failing, and the quota resets at midnight Pacific time. ### Input | Field | What it does | |---|---| | `urls` | One page URL per row, up to 300. A missing `https://` is added for you. | | `apiKey` | Your own Google API key. Required. | | `strategy` | `mobile`, `desktop` or `both`. `both` returns two rows per URL and is charged as two. | | `allCategories` | Off by default. On adds two more score columns, but Lighthouse needs about two and a half times longer per URL. Keep those runs under 250 URLs. | | `locale` | Optional language for the wording of the fixes, for example `nl`. | ### Input example ```json { "urls": ["https://www.wikipedia.org", "https://www.gov.uk"], "apiKey": "AIza...your own key...", "strategy": "mobile", "allCategories": false, "locale": "" } ``` ### Output One row per URL and device: - `url`, `finalUrl`, `strategy`, `fetchedAt`, `lighthouseVersion` - `performanceScore` and `seoScore` (0 to 100). With `allCategories` on you also get `accessibilityScore` and `bestPracticesScore`; with it off those two columns are not in the output at all, rather than present and empty - `fieldOverall`, `fieldLcpMs`, `fieldInpMs`, `fieldCls`, `fieldFcpMs`, `fieldTtfbMs`, each with its own `...Rating` of `FAST`, `AVERAGE` or `SLOW` - `originOverall`: the same verdict for the whole domain - `labLcpMs`, `labFcpMs`, `labCls`, `labTbtMs`, `labSpeedIndexMs`, `labTimeToInteractiveMs`, `labServerResponseMs`, `totalBytesKb` - `topOpportunities`: the five heaviest fixes Lighthouse found, largest first, each with the time it would save - `opportunitySavingsMs`: what all the fixes together would save `fieldCls` is a real layout-shift score such as `0.15`. Google's API returns that number multiplied by a hundred; this actor converts it back so the column matches what you see on pagespeed.web.dev. Error codes: `INVALID_URL`, `INVALID_KEY`, `QUOTA_EXCEEDED`, `PAGE_FAILED`, `FETCH_FAILED`. A page Lighthouse cannot load becomes a `PAGE_FAILED` row and is never charged. ### Output example A real row, measured on 19-09-2026: ```json { "url": "https://www.telegraaf.nl/", "finalUrl": "https://www.telegraaf.nl/", "strategy": "mobile", "fetchedAt": "2026-09-19T16:14:56.226Z", "lighthouseVersion": "13.4.1", "performanceScore": 30, "seoScore": 92, "fieldOverall": "AVERAGE", "fieldLcpMs": 1418, "fieldLcpRating": "FAST", "fieldCls": 0.15, "fieldClsRating": "AVERAGE", "fieldTtfbMs": 855, "originOverall": "SLOW", "labLcpMs": 14617, "labCls": 0.123, "labTbtMs": 1565, "totalBytesKb": 4571, "topOpportunities": [ "Reduce unused JavaScript: 1.8 s", "Reduce unused CSS: 0.5 s" ], "opportunitySavingsMs": 2200, "status": "ok" } ``` That row shows the two things people read wrongly, which is why it is here rather than a tidy invented example. `fieldCls` is 0.15 for this page while `originOverall` says SLOW for the whole domain: the per-metric columns always belong to the page, the origin verdict never does. And the field columns say FAST where the lab columns are far slower, because the field numbers come from real visitors over the last 28 days on their own devices, and the lab number is one simulated phone on a throttled connection. Both are true and they answer different questions. ### Who this is not for Anyone without a Google API key: this actor runs on your own key, which is free and takes about two minutes to create (see above). We cannot supply one, because Google's terms do not allow reselling access to their API. It is also not a crawler. It measures the URLs you give it and follows no links, so a whole site means feeding it a URL list, for example from a sitemap. And it is not a monitor: one run is one measurement at one moment. Google's own numbers move between runs, especially the lab columns, so compare the same page over time rather than two pages once. ### Speed Google needs 10 to 40 seconds per URL, and that is outside anyone's control. This actor runs eight in parallel, measured on the same 25 real sites: | Setting | Time for 25 URLs | 300 URLs would take | |---|---|---| | Default (performance and SEO) | 118 s | about 24 minutes | | `allCategories` on | 293 s | about 59 minutes | Eight in parallel is the measured optimum, not a guess: at twelve, Google starts answering with server errors, the retries pile up and the same run took more than twice as long. A run stops after one hour, so with `allCategories` on, keep the list under 250 URLs. ### Related actors from steadydata - [technical-seo-audit](https://apify.com/steadydata/technical-seo-audit): titles, headings, canonicals and indexability for the same pages - [website-tech-stack](https://apify.com/steadydata/website-tech-stack): which technologies a site runs on - [sitemap-urls](https://apify.com/steadydata/sitemap-urls): turn a sitemap into the URL list you feed to this actor ### Pricing Pay per event: one `url-audited` event per delivered row. No charge for inputs that fail, no separate platform-usage surcharge. Google charges you nothing for the API itself. **Free Apify plan:** this actor delivers up to 25 rows per run for accounts on the Apify free plan, and then stops with a message. That limit is set by us, not by Apify. It exists so the actor keeps paying for itself for the people who do pay. Any paid Apify plan runs it at full size, billed per delivered row, with failed rows never charged. **Reviews:** if this actor saves you time, a short review on this page is the one thing that helps most. Ratings are what other buyers look at first, and we have no other way to ask. ### FAQ **Why do I need my own key?** Google's API terms forbid reselling access to their API or the content it returns. An actor that ran on our key and charged per row would fall under both. With your own key you hold the agreement with Google, you use your own quota, and you are buying software rather than Google's data. It is free, and the quota (25,000 requests a day) is far more than this actor needs. **Does my key stay private?** The field is marked as secret, so Apify stores it encrypted and it is not visible in the run input. It is used for nothing but the PageSpeed requests. **Why are the field columns empty for my page?** Those come from the Chrome User Experience Report: real visitors over the last 28 days. A page without enough traffic has no field data, and Google returns nothing rather than an estimate. The lab columns are always there, because Lighthouse measures those itself. **Why is a score different from what I see on pagespeed.web.dev?** Lighthouse is a simulation and repeats are not identical. Run to run, a performance score of a few points apart is normal for the same page. Use the trend over several runs, not one number. **What happens when a page fails to load?** It becomes a `PAGE_FAILED` row with the reason, and it is not charged. A run that hits the hour limit stops early and reports which URLs it did not reach, also uncharged. # Changelog This Actor's version history is a separate document: https://apify.com/steadydata/pagespeed-insights-bulk/changelog.md # Actor input Schema ## `urls` (type: `array`): One page URL per row, up to 300. A missing https:// is added for you. ## `apiKey` (type: `string`): Required, and free. In Google Cloud: enable the PageSpeed Insights API for a project, then create an API key and restrict it to that one API. The key is yours, the quota is yours, and it is only used for these requests. ## `strategy` (type: `string`): Which device Lighthouse simulates. 'Both' returns two rows per URL and is charged as two. ## `allCategories` (type: `boolean`): Off by default: performance and SEO are scored, and only those two columns are returned. On adds two more score columns, but Lighthouse then needs about two and a half times longer per URL, so keep runs under 250 URLs. ## `locale` (type: `string`): Optional BCP-47 code for the wording of the fixes, for example nl or de. Leave empty for English. ## Actor input object example ```json { "urls": [ "https://www.wikipedia.org", "https://www.gov.uk" ], "strategy": "mobile", "allCategories": false, "locale": "" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.wikipedia.org", "https://www.gov.uk" ] }; // Run the Actor and wait for it to finish const run = await client.actor("steadydata/pagespeed-insights-bulk").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": [ "https://www.wikipedia.org", "https://www.gov.uk", ] } # Run the Actor and wait for it to finish run = client.actor("steadydata/pagespeed-insights-bulk").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.wikipedia.org", "https://www.gov.uk" ] }' | apify call steadydata/pagespeed-insights-bulk --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,steadydata/pagespeed-insights-bulk" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/QTeTCQtJNWkMT09uo/builds/53K3hBddYerR20xkX/openapi.json