PageSpeed and SEO Score API

PageSpeed and SEO Score API
Run a PageSpeed and SEO quality check for a URL and return category scores, core web metrics, and prioritized optimization opportunities.

Method: GET
Path: /v1/websitetools/pagespeed-score
Demo: https://api.gugudata.io/v1/websitetools/pagespeed-score/demo
OpenAPI: https://gugudata.io/assets/openapi/gugudata.openapi.3.1.json

Request Parameters:

appkey (string, required): Application key used for request authentication.

url (string, required): URL to analyze.

strategy (string, optional): desktop or mobile.

locale (string, optional): Locale for the analysis result.

categories (string, optional): Comma-separated categories such as performance, accessibility, best-practices, and seo.

forceRefresh (boolean, optional): Bypass cache when supported.

Response Fields:

dataStatus (object, required): Response metadata returned by the current v1 contract.

data.scores.performance (number, optional): Performance score.

data.scores.accessibility (number, optional): Accessibility score.

data.scores.bestPractices (number, optional): Best practices score.

data.scores.seo (number, optional): SEO score.

data.coreMetrics (object, optional): Core page speed metrics.

data.opportunities (array, optional): Main optimization suggestions.

HTTP Status Codes:

200: Request processed successfully. Some endpoints expose a separate application-level status field in the response body, such as dataStatus.statusCode.

400: Invalid request parameters or request format. Check required fields, data types, and request body format.

401: Missing or unknown application key. Provide a valid appkey with the request.

403: The application key is recognized but access is not allowed. The key may be expired, inactive, or not permitted for the requested API.

429: Request rate or trial usage limit exceeded. Reduce concurrency or retry after the limit window resets.

500: Internal service error. Retry later or contact support if the error persists.

503: Upstream service unavailable. Retry later; the requested upstream dependency is temporarily unavailable.

Business Status Codes:

No endpoint-specific business status codes are documented.

Key Features:

Production-ready HTTPS API with stable request and response contracts.

Details:
https://gugudata.io/details/pagespeed-score

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Request

Request Code Samples

Responses