网页性能与 SEO 评分 API 接口
接口详情官网地址: https://www.gugudata.com/api/details/pagespeed-score
网页性能与 SEO 评分 API 可获取网页性能、可访问性、最佳实践与 SEO 评分，页面评分、SEO 评分、页面性能等关键词场景常会用到。接口适合用于站点内容抽取与网页分析、SEO 检查与页面结构处理、网页自动化采集和结构化输出等业务场景，方便开发者直接在应用、脚本或数据流程中接入。
1. 产品功能
- 获取网页性能、可访问性、最佳实践与 SEO 四类评分；
- 支持 mobile 与 desktop 两种检测策略；
- 返回 FCP、LCP、Speed Index、TBT、CLS 等核心页面体验指标；
- 返回标题、描述、可抓取链接、索引可用性、Canonical 等 SEO 审计摘要；
- 汇总主要待优化项，便于快速定位页面优化方向；
- 支持缓存检测结果，适合定期监控页面表现；
- 全接口支持 HTTPS（TLS v1.0 / v1.1 / v1.2 / v1.3）；
- 全面兼容 Apple ATS；
- 全国多节点 CDN 部署；
- 接口极速响应，多台服务器构建 API 接口负载均衡；
2. API 文档
接口地址: https://api.gugudata.com/websitetools/pagespeed-score
返回格式: application/json; charset=utf-8
请求方式: GET
请求协议: HTTPS
请求示例: https://api.gugudata.com/websitetools/pagespeed-score?appkey=YOUR_APPKEY&url=YOUR_VALUE&strategy=mobile&locale=zh-CN&categories=YOUR_VALUE&forceRefresh=false
数据预览: https://www.gugudata.com/preview/pagespeed-score
接口测试: https://api.gugudata.com/websitetools/pagespeed-score/demo
3. 请求参数
| 参数名 | 参数类型 | 是否必须 | 默认值 | 备注 |
|---|---|---|---|---|
| appkey | string | 是 | YOUR_APPKEY | 付费后获取的 APPKEY |
| url | string | 是 | YOUR_VALUE | 需要检测评分的网页 URL，必须是有效的 HTTP 或 HTTPS 链接 |
| strategy | string | 否 | mobile | 检测策略，可选 mobile 或 desktop，默认 mobile |
| locale | string | 否 | zh-CN | 返回语言区域，默认 zh-CN |
| categories | string | 否 | YOUR_VALUE | 评分类别，可选 performance、accessibility、best-practices、seo，多个值用英文逗号分隔 |
| forceRefresh | boolean | 否 | false | 是否重新检测并刷新结果，默认 false |
4. 返回参数
| 参数名 | 参数类型 | 备注 |
|---|---|---|
| DataStatus.StatusCode | int | 接口返回状态码 |
| DataStatus.StatusDescription | string | 接口返回状态说明 |
| DataStatus.ResponseDateTime | string | 接口数据返回时间 |
| DataStatus.DataTotalCount | int | 此条件下的总数据量，正常返回时为 1 |
| Data.RequestedUrl | string | 请求检测的网页 URL |
| Data.FinalUrl | string | 检测完成后的最终网页 URL |
| Data.Strategy | string | 本次检测使用的策略 |
| Data.Locale | string | 本次检测使用的语言区域 |
| Data.ReportVersion | string | 检测报告版本 |
| Data.FetchTime | string | 检测报告生成时间 |
| Data.Cached | boolean | 本次返回是否来自已缓存结果 |
| Data.Scores.Performance | int | 性能评分，范围 0 到 100，没有对应分类时返回 null |
| Data.Scores.Accessibility | int | 可访问性评分，范围 0 到 100，没有对应分类时返回 null |
| Data.Scores.BestPractices | int | 最佳实践评分，范围 0 到 100，没有对应分类时返回 null |
| Data.Scores.Seo | int | SEO 评分，范围 0 到 100，没有对应分类时返回 null |
| Data.Metrics.FirstContentfulPaintMs | float | 首次内容绘制耗时，单位毫秒 |
| Data.Metrics.LargestContentfulPaintMs | float | 最大内容绘制耗时，单位毫秒 |
| Data.Metrics.SpeedIndexMs | float | 速度指数，单位毫秒 |
| Data.Metrics.TotalBlockingTimeMs | float | 总阻塞时间，单位毫秒 |
| Data.Metrics.CumulativeLayoutShift | float | 累计布局偏移 |
| Data.SeoAudits.Title | object | 网页标题 SEO 审计摘要 |
| Data.SeoAudits.MetaDescription | object | 网页描述 SEO 审计摘要 |
| 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 | 待优化项 ID |
| Data.TopIssues[].Title | string | 待优化项标题 |
| Data.TopIssues[].Score | int | 待优化项得分，范围 0 到 100，没有得分时返回 null |
| Data.TopIssues[].DisplayValue | string | 待优化项展示值 |
5. 错误码说明
| 状态码 | 错误说明 | 备注 |
|---|---|---|
| 100 | 正常返回 | 可通过判断此状态码断言接口正常返回。 |
| 501 | 参数错误 | 请检查 URL、strategy、locale、categories 等参数是否正确。 |
| 502 | 请求频率受限 | 默认情况下，每个接口提供 10 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包。 |
| 503 | APPKEY 权限超限或订单到期 | 请前往开发者中心检查 APPKEY 状态与订单有效期。 |
| 504 | APPKEY 错误 | 请检查传递的 APPKEY 是否正确。 |
| 505 | 请求次数超出接口限制 | 请检查接口剩余请求次数与配额限制。 |
| 900 | 接口内部响应错误 | 接口服务暂时不可用，请稍后重试。 |
6. 适用场景
- 适合用于站点巡检、SEO 监控和页面质量看板，快速补齐网页性能与 SEO 评分数据能力。
- 适合用于页面发布前检查、竞品页面分析和持续优化流程，减少人工打开工具逐页检测的成本。
- 适合用于网页自动化采集与结构化输出，将评分、核心指标和待优化项接入后台系统、数据任务或运营报表。
7. 相关接口
- 可搭配使用：
获取任意站点标题与图标，适合补充同类场景的接口能力。 - 可搭配使用：
域名 Whois 查询，适合补充同类场景的接口能力。 - 可搭配使用：
网页可读内容抽取，适合补充同类场景的接口能力。
–EOF–
转载须以超链接形式标明文章原始出处和作者信息
