# PageSpeed + Accessibility Audit - Real Lighthouse Scores (`santamaria-automations/pagespeed-accessibility-audit`) Actor Measure Core Web Vitals, Lighthouse Performance, and Accessibility scores for any website via Google's official PageSpeed Insights API. One row per URL with numeric scores, the full Core Web Vitals set (LCP, CLS, TBT, TTI...), and a ranked list of failing accessibility audits. Pay-per-result. - **URL**: https://apify.com/santamaria-automations/pagespeed-accessibility-audit.md - **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community) - **Categories:** Developer tools, Lead generation, SEO tools - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## PageSpeed + Accessibility Audit Real Lighthouse scores for any website, in bulk. Feed a list of URLs, get back Performance and Accessibility scores, Core Web Vitals, and a ranked list of failing accessibility issues. One row per URL. Backed by Google's official PageSpeed Insights API. ### What It Does For every input URL the actor makes one call to Google's PageSpeed Insights (PSI) API v5 and extracts: - **Lighthouse Performance score** (0-100) - **Lighthouse Accessibility score** (0-100) - **Core Web Vitals**: LCP, CLS, FCP, TBT, Speed Index, Time to Interactive, TTFB, plus INP (Interaction to Next Paint) from CrUX field data - **Accessibility issues**: up to 20 failing audits, sorted by impact, with the specific WCAG rule and the count of failing elements per page - **Flags**: `good` / `needs_improvement` / `poor` buckets matching Lighthouse's own thresholds One PSI call returns both Performance and Accessibility, so you pay for one round-trip and get both signals. Best Practices and SEO categories are available via the `includeExtraCategories` toggle. ### How to get your Google API key (3 minutes) Bring your own key. Google offers a generous free tier of **25,000 queries per day per Google Cloud project** with no credit card required. 1. Sign in at [console.cloud.google.com](https://console.cloud.google.com) and pick or create a project (skip the billing prompt when it appears — PSI is free). 2. Open the [API Library](https://console.cloud.google.com/apis/library), search for **"PageSpeed Insights API"**, and click **Enable**. 3. Open [Credentials](https://console.cloud.google.com/apis/credentials), click **Create Credentials → API key**, copy the generated value. 4. Recommended: click the new key → **Edit API key → Restrict key**. Under **API restrictions**, select **Restrict key** and check only **PageSpeed Insights API**. This makes a leaked key useless for paid Google APIs. 5. Paste the key into the actor's `googleApiKey` input field. The actor will refuse to start without a key and won't consume any billing events until you supply one. ### Input Two shapes accepted, mix them freely. Flat URL list: ```json { "urls": ["https://www.mozilla.org/", "https://web.dev/"], "googleApiKey": "AIza...", "strategy": "mobile" } ```` Companies shape (with `company_id` passthrough for CRM join-back): ```json { "companies": [ { "company_id": "acme-42", "website_url": "https://example-company.example" } ], "googleApiKey": "AIza..." } ``` #### Configuration | Field | Default | Description | |-------|---------|-------------| | `googleApiKey` | *(required)* | Your Google Cloud API key with PageSpeed Insights API enabled | | `strategy` | `mobile` | `mobile` or `desktop` Lighthouse profile | | `includeExtraCategories` | `false` | Also return Best Practices + SEO scores | | `outputLanguage` | `en` | ISO 639-1 code for issue titles (en, de, fr, es, ja, ...) | | `maxConcurrency` | `5` | Parallel PSI calls in flight (max 10) | ### Output One row per input URL: ```json { "company_id": "acme-42", "url": "https://example-company.example/", "final_url": "https://example-company.example/", "strategy": "mobile", "fetch_time": "2026-07-18T13:00:00.000Z", "scores": { "performance": 87, "accessibility": 92, "best_practices": null, "seo": null }, "core_web_vitals": { "lcp_ms": 2100, "lcp_score": 0.85, "inp_ms": 162, "inp_flag": "good", "cls": 0.08, "cls_score": 0.92, "fcp_ms": 1800, "fcp_score": 0.88, "ttfb_ms": 640, "tbt_ms": 210, "si_ms": 3200, "tti_ms": 4100 }, "accessibility_issues": [ {"id": "color-contrast", "title": "Background and foreground colors do not have a sufficient contrast ratio.", "impact": "serious", "count": 3}, {"id": "image-alt", "title": "Image elements do not have [alt] attributes.", "impact": "critical", "count": 1} ], "flags": { "performance_flag": "good", "accessibility_flag": "needs_improvement" }, "psi_status": "success", "scraped_at": "2026-07-18T13:00:05Z" } ``` Failed audits still emit a row with `psi_status: "failed"` and `psi_error` populated, so N URLs in always equals N rows out. ### How To Get A Google API Key The PageSpeed Insights API is free. No card required. Steps: 1. Go to the [Google Cloud Console](https://console.cloud.google.com/). 2. Create a new project (or pick an existing one). 3. Open the [PageSpeed Insights API page](https://console.cloud.google.com/apis/library/pagespeedonline.googleapis.com) and click **Enable**. 4. Go to **APIs & Services** > **Credentials** > **Create Credentials** > **API key**. 5. Copy the key and paste it into the `googleApiKey` input field. Free quota per project: **25,000 queries per day**. That is enough to audit a full 25k-URL prospect list every 24 hours from a single project. Full setup guide: [Get Started with the PageSpeed Insights API](https://developers.google.com/speed/docs/insights/v5/get-started). ### Pricing Pay-per-result via Apify Pay-Per-Event billing: | Event | Price | Description | |-------|-------|-------------| | Actor start | $0.001 | Charged once per run | | URL audited | $0.005 | Charged per audit row (success or failed) | Auditing 1,000 URLs costs about $5. No monthly fees, no minimums. The Google API side stays free within the 25,000/day quota. ### Related Actors Discovery: - [Google Maps Scraper](https://apify.com/nanoscrape/google-maps-scraper) - collect places for a niche and city Enrichment: - [GBP Completeness Audit](https://apify.com/nanoscrape/gbp-completeness-audit) - score Google Business Profiles for local SEO lead priority - [Website Email Scraper](https://apify.com/nanoscrape/website-email-scraper) - extract emails, phones, social URLs from company sites - [AI Icebreaker Generator](https://apify.com/nanoscrape/ai-icebreaker) - one personalized cold-outreach line per business ### Issues & Feature Requests If a metric you need is missing from the row shape or you want a different scoring bucket, open an issue on the actor's Issues tab and we will take a look. # Actor input Schema ## `urls` (type: `array`): List of website URLs to audit. Each URL is sent to Google PageSpeed Insights and yields one output row with Performance + Accessibility scores. ## `companies` (type: `array`): Alternative to `urls`. Each entry carries a company\_id that is echoed on the output row, enabling downstream join-back to your CRM or dataset. Combine with `urls` freely. ## `googleApiKey` (type: `string`): Your Google Cloud API key with the PageSpeed Insights API enabled. Free tier: 25,000 queries per day per Google Cloud project (no credit card required). Get a key in about 3 minutes: (1) Sign in at https://console.cloud.google.com and pick or create a project (skip the billing prompt -- PSI is free). (2) Open the API Library at https://console.cloud.google.com/apis/library, search for 'PageSpeed Insights API', click Enable. (3) Open Credentials at https://console.cloud.google.com/apis/credentials, click 'Create Credentials' -> 'API Key', copy the value. (4) Recommended: edit the key, restrict it to just the PageSpeed Insights API so a leaked key can't be abused. Paste the key here. ## `strategy` (type: `string`): Which Lighthouse profile to run. `mobile` matches Google's own default and is the more relevant surface for most local businesses. `desktop` is faster and reports higher scores on average. ## `includeExtraCategories` (type: `boolean`): When enabled, PSI also returns Best Practices and SEO Lighthouse scores in the same API call. Still one PSI call per URL, but the response payload is larger. Off by default to keep runs lean. ## `outputLanguage` (type: `string`): Language for PSI audit titles + descriptions (Accessibility issue titles etc.). Uses standard ISO 639-1 codes. Pass any ISO 639-1 language code: en, de, fr, ja, es, pt, it, ko, zh-CN, ar, nl, pl, sv, da, fi, no, cs, hu, ro, el, tr, th, vi, id, and more. Category names in the output stay in English. ## `maxConcurrency` (type: `integer`): How many PSI calls to keep in flight at once. PSI free tier permits 240 queries per minute per project, so 5 concurrent is safely under the limit. Raise to 10 for large batches, lower to 1 if you hit rate limits. ## `proxyConfiguration` (type: `object`): Not used by the audit itself - PageSpeed Insights is a public Google API called directly. Present for schema consistency with sibling add-ons. ## Actor input object example ```json { "urls": [ "https://www.wikipedia.org/", "https://www.mozilla.org/", "https://web.dev/" ], "strategy": "mobile", "includeExtraCategories": false, "outputLanguage": "en", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `audits` (type: `string`): Dataset of Lighthouse audits # 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.mozilla.org/", "https://web.dev/" ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/pagespeed-accessibility-audit").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.mozilla.org/", "https://web.dev/", ], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/pagespeed-accessibility-audit").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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.mozilla.org/", "https://web.dev/" ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call santamaria-automations/pagespeed-accessibility-audit --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=santamaria-automations/pagespeed-accessibility-audit", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "PageSpeed + Accessibility Audit - Real Lighthouse Scores", "description": "Measure Core Web Vitals, Lighthouse Performance, and Accessibility scores for any website via Google's official PageSpeed Insights API. One row per URL with numeric scores, the full Core Web Vitals set (LCP, CLS, TBT, TTI...), and a ranked list of failing accessibility audits. Pay-per-result.", "version": "1.0", "x-build-id": "owFNNQUr1yY5fkibo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/santamaria-automations~pagespeed-accessibility-audit/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-santamaria-automations-pagespeed-accessibility-audit", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/santamaria-automations~pagespeed-accessibility-audit/runs": { "post": { "operationId": "runs-sync-santamaria-automations-pagespeed-accessibility-audit", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/santamaria-automations~pagespeed-accessibility-audit/run-sync": { "post": { "operationId": "run-sync-santamaria-automations-pagespeed-accessibility-audit", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "googleApiKey" ], "properties": { "urls": { "title": "Website URLs", "type": "array", "description": "List of website URLs to audit. Each URL is sent to Google PageSpeed Insights and yields one output row with Performance + Accessibility scores.", "items": { "type": "string" } }, "companies": { "title": "Companies (with company_id passthrough)", "type": "array", "description": "Alternative to `urls`. Each entry carries a company_id that is echoed on the output row, enabling downstream join-back to your CRM or dataset. Combine with `urls` freely.", "items": { "type": "object", "properties": { "company_id": { "title": "Company ID", "type": "string", "description": "Your internal identifier - echoed on the output row so you can join audit results back to your source data." }, "website_url": { "title": "Website URL", "type": "string", "description": "The company's website URL to audit." } }, "required": [ "website_url" ] } }, "googleApiKey": { "title": "Google API Key (required)", "type": "string", "description": "Your Google Cloud API key with the PageSpeed Insights API enabled. Free tier: 25,000 queries per day per Google Cloud project (no credit card required). Get a key in about 3 minutes: (1) Sign in at https://console.cloud.google.com and pick or create a project (skip the billing prompt -- PSI is free). (2) Open the API Library at https://console.cloud.google.com/apis/library, search for 'PageSpeed Insights API', click Enable. (3) Open Credentials at https://console.cloud.google.com/apis/credentials, click 'Create Credentials' -> 'API Key', copy the value. (4) Recommended: edit the key, restrict it to just the PageSpeed Insights API so a leaked key can't be abused. Paste the key here." }, "strategy": { "title": "Lighthouse Strategy", "enum": [ "mobile", "desktop" ], "type": "string", "description": "Which Lighthouse profile to run. `mobile` matches Google's own default and is the more relevant surface for most local businesses. `desktop` is faster and reports higher scores on average.", "default": "mobile" }, "includeExtraCategories": { "title": "Include Best Practices + SEO categories", "type": "boolean", "description": "When enabled, PSI also returns Best Practices and SEO Lighthouse scores in the same API call. Still one PSI call per URL, but the response payload is larger. Off by default to keep runs lean.", "default": false }, "outputLanguage": { "title": "Output Language", "type": "string", "description": "Language for PSI audit titles + descriptions (Accessibility issue titles etc.). Uses standard ISO 639-1 codes. Pass any ISO 639-1 language code: en, de, fr, ja, es, pt, it, ko, zh-CN, ar, nl, pl, sv, da, fi, no, cs, hu, ro, el, tr, th, vi, id, and more. Category names in the output stay in English.", "default": "en" }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many PSI calls to keep in flight at once. PSI free tier permits 240 queries per minute per project, so 5 concurrent is safely under the limit. Raise to 10 for large batches, lower to 1 if you hit rate limits.", "default": 5 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Not used by the audit itself - PageSpeed Insights is a public Google API called directly. Present for schema consistency with sibling add-ons." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```