网页性能与 SEO 评分

检测公开网页的性能、可访问性、最佳实践和 SEO 表现，并返回主要优化项。
接口特性：

一次检测获得性能、可访问性、最佳实践与 SEO 四类评分；

支持移动端与桌面端策略，便于比较不同设备下的页面体验；

返回 FCP、LCP、Speed Index、TBT、CLS 等核心页面体验指标；

展示标题、描述、Canonical、robots.txt 与移动端视口等 SEO 检查结果；

汇总最多 10 项主要问题，帮助快速确定页面优化优先级。
详情页：https://www.gugudata.com/api/details/pagespeed-score

当前接口契约

接口详情：https://www.gugudata.com/api/details/pagespeed-score

功能说明

返回 FCP、LCP、Speed Index、TBT 与 CLS 等核心指标；

可按需选择检测类别，聚焦本次检查目标；

支持语言区域参数，便于阅读对应语言的检查说明；

支持重新检测指定页面，方便核对优化前后的变化；

返回请求地址、最终地址、检测时间和报告版本，便于留档对比；

适合网站巡检、上线前质检、SEO 看板与页面体验优化；

请求参数

参数	类型	必填	默认值	说明
appkey	string	否	无	接口 APPKEY，支持 Query、Header 或 Bearer 传递。 AppKey 整体必填；在本操作已声明支持的鉴权位置任选一个提供，本位置无需重复填写。多处填写时须一致。
url	string	是	无	公开可访问的 HTTP 或 HTTPS 网页地址，最长 2048 个字符。
strategy	string	否	mobile	检测策略，可选 mobile 或 desktop，默认 mobile。
locale	string	否	zh-CN	检测说明使用的语言区域，默认 zh-CN。
categories	string	否	performance,accessibility,best-practices,seo	检测类别，多个值使用英文逗号分隔。
forceRefresh	boolean	否	false	是否重新检测指定网页，默认 false。

正常响应字段

字段	类型	说明
DataStatus.RequestParameter	string	本次实际业务请求参数，不包含鉴权凭据；Demo 展示对应样例输入。
DataStatus.StatusCode	integer	接口业务状态码。
DataStatus.StatusDescription	string	接口业务状态说明。
DataStatus.ResponseDateTime	string	接口响应时间。
DataStatus.DataTotalCount	integer	成功时为 1，失败时为 0。
Data.RequestedUrl	string	请求检测的网页地址。
Data.FinalUrl	string	检测完成后的最终网页地址。
Data.Strategy	string	本次检测使用的设备策略。
Data.Locale	string	本次检测使用的语言区域。
Data.ReportVersion	string	检测报告版本。
Data.FetchTime	string	检测报告生成时间。
Data.Cached	boolean	本次是否返回近期已有的页面检测结果。
Data.Scores.Performance	integer	性能评分，范围 0 到 100。
Data.Scores.Accessibility	integer	可访问性评分，范围 0 到 100。
Data.Scores.BestPractices	integer	最佳实践评分，范围 0 到 100。
Data.Scores.Seo	integer	SEO 评分，范围 0 到 100。
Data.Metrics.FirstContentfulPaintMs	number	首次内容绘制耗时，单位毫秒。
Data.Metrics.LargestContentfulPaintMs	number	最大内容绘制耗时，单位毫秒。
Data.Metrics.SpeedIndexMs	number	速度指数，单位毫秒。
Data.Metrics.TotalBlockingTimeMs	number	总阻塞时间，单位毫秒。
Data.Metrics.CumulativeLayoutShift	number	累计布局偏移。
Data.SeoAudits.Title	object	网页标题检查摘要。
Data.SeoAudits.MetaDescription	object	网页描述检查摘要。
Data.SeoAudits.CrawlableAnchors	object	可抓取链接检查摘要。
Data.SeoAudits.IsCrawlable	object	索引可用性检查摘要。
Data.SeoAudits.Canonical	object	Canonical 链接检查摘要。
Data.SeoAudits.HttpStatusCode	object	网页 HTTP 状态检查摘要。
Data.SeoAudits.RobotsTxt	object	robots.txt 检查摘要。
Data.SeoAudits.Viewport	object	移动端视口检查摘要。
Data.TopIssues	array	主要问题列表，最多返回 10 项。
Data.TopIssues[].Id	string	主要问题标识。
Data.TopIssues[].Title	string	主要问题标题。
Data.TopIssues[].Score	integer	主要问题得分，范围 0 到 100。
Data.TopIssues[].DisplayValue	string	主要问题展示值。

业务状态说明

业务状态码	业务状态码解释	备注
100	请求成功	网页检测结果已返回。
501	参数错误	请检查网页地址及检测参数。
502	请求频率受限	请稍后重试。
503	订单已到期	请检查接口服务有效期。
504	APPKEY 错误	请检查 APPKEY 是否有效。
505	调用额度已用完	请检查剩余调用额度。
900	服务内部错误	请稍后重试。
901	网页检测服务暂时不可用	请稍后重试。

常见问题

可以检测哪些网页地址？

每次提交一个公开可访问的 HTTP 或 HTTPS 网页地址，最长 2048 个字符。页面发生重定向时，可用 RequestedUrl 核对请求地址，用 FinalUrl 确认实际检测的页面。

如何对比移动端和桌面端评分？

分别使用 strategy=mobile 和 strategy=desktop 检测同一页面，默认使用移动端策略。复测优化效果时，使用相同的地址、策略和评分类别。检测说明的语言可通过 locale 指定。

可以只看性能或 SEO 评分吗？

可以。只查性能时传 categories=performance，同时查性能和 SEO 时传 categories=performance,seo。省略时检测性能、可访问性、最佳实践和 SEO 四类。没有对应分值时，Scores 中的该类评分为 null。

怎样判断结果是否来自缓存？

Cached 表示是否复用了已有报告，FetchTime 是报告生成时间。页面更新后，可传 forceRefresh=true 请求重新检测，并核对返回的报告时间。

怎样用评分和主要问题定位优化项？

先看 Scores 中较低的类别，再结合 Metrics 和 TopIssues 定位页面问题。评分和性能指标来自 Lighthouse 模拟检测。实际用户体验可结合真实用户数据查看，搜索收录和排名可在 Search Console 中核实。

Demo 和正式接口有什么区别？

Demo 无需 AppKey，使用固定网页的历史报告，供接口请求测试和开发调试。成功响应与正式接口使用相同的数据结构。正式接口使用对应的 AppKey，按传入的网页地址和参数进行检测。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

请求成功，业务码 100。

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 0
    },
    "Data": {
        "ReportVersion": "string",
        "Scores": {
            "Performance": 0,
            "Seo": 0,
            "BestPractices": 0,
            "Accessibility": 0
        },
        "SeoAudits": {
            "Viewport": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "MetaDescription": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "HttpStatusCode": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "IsCrawlable": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "Title": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "RobotsTxt": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "Canonical": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            },
            "CrawlableAnchors": {
                "Id": "string",
                "Description": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            }
        },
        "RequestedUrl": "http://example.com",
        "Metrics": {
            "CumulativeLayoutShift": 0,
            "TotalBlockingTimeMs": 0,
            "LargestContentfulPaintMs": 0,
            "SpeedIndexMs": 0,
            "FirstContentfulPaintMs": 0
        },
        "TopIssues": [
            {
                "Id": "string",
                "Score": 0,
                "DisplayValue": "string",
                "Title": "string"
            }
        ],
        "FinalUrl": "http://example.com",
        "Locale": "string",
        "Cached": true,
        "FetchTime": "string",
        "Strategy": "mobile"
    }
}

🟠400参数错误，业务码 501。

🟠401缺少或无效 APPKEY，业务码 504。

🟠403订单到期或额度不可用，业务码 503 或 505。

🟠429请求频率受限，业务码 502。

🔴500服务内部错误，业务码 900。

🔴503页面评分服务暂时不可用，业务码 901。

当前接口契约#

功能说明#

请求参数#

正常响应字段#

业务状态说明#

常见问题#

可以检测哪些网页地址？#

如何对比移动端和桌面端评分？#

可以只看性能或 SEO 评分吗？#

怎样判断结果是否来自缓存？#

怎样用评分和主要问题定位优化项？#

Demo 和正式接口有什么区别？#

请求参数

请求示例代码

返回响应

当前接口契约

功能说明

请求参数

正常响应字段

业务状态说明

常见问题

可以检测哪些网页地址？

如何对比移动端和桌面端评分？

可以只看性能或 SEO 评分吗？

怎样判断结果是否来自缓存？

怎样用评分和主要问题定位优化项？

Demo 和正式接口有什么区别？