Unofficial Metacritic API

This API provides programmatic access to metacritic.com metadata, including metascore, user score, review counts, release dates, and platform-specific availability. It is built for applications, dashboards, and research tools that need structured data

原始信息汇总

数据集概述

• 名称：Unofficial Metacritic API
• 提供者：selyakovadim
• 类别：Gaming
• 服务等级：100%
• 延迟：267ms

核心功能

该 API 提供对 metacritic.com 结构化游戏元数据和评分信息的程序化访问，包括：

• 游戏标题（title）与唯一标识符（slug）
• 支持平台（platform）
• 平台特定发布日期（release_date）
• 评论家评分（meta_score）与评论数（reviews_count）
• 用户评分（user_score）与评论数（reviews_count）

数据为缓存数据，非实时抓取，以保证响应可预测性和性能。

端点（Endpoints）

方法	端点	描述
GET	/v1/games	以游标分页列出游戏，每页最多100条
GET	/v1/games/{slug}	根据唯一 slug 获取单个游戏详情

该 API 为只读，不支持创建、更新或删除数据。

数据模型

• Game：顶层资源，包含 title、slug、platforms（GamePlatform 数组）、refreshed_at（最后刷新日期）。
• GamePlatform：包含 platform（平台标识符）、release_date、user_reviews（user_score 和 reviews_count，可为 null）、critic_reviews（meta_score 0-100 和 reviews_count，可为 null）。

支持平台

包括：pc、ps1-ps5、ps-vita、psp、xbox、xbox-360、xbox-one、xbox-series-x、nintendo-64、gamecube、nintendo-ds、wii、3ds、wii-u、nintendo-switch、nintendo-switch-2、mobile。

错误处理

所有错误返回 JSON 格式，包含 message 字段。常见 HTTP 状态码：

• 200：成功
• 401：RapidAPI 网关访问缺失或配置错误
• 403：RapidAPI 网关访问无效或配置错误
• 404：请求的游戏未找到

使用提示

• 建议缓存响应以减少延迟和请求量。
• 存储 slug 作为稳定标识符，用于后续通过 /v1/games/{slug} 刷新详情。
• 处理可能为 null 的评分字段，不应将其解释为 0 分。
• 使用游标分页，不要手动构造游标值。
• 数据更新频率：遗留平台每月更新，当前活跃平台每周更新。
• 完整评论内容未暴露，以尊重 Metacritic 版权数据。

示例用例

• 游戏发现工具
• 评分对比仪表盘
• 平台特定游戏目录
• 游戏收藏与进度追踪器
• 评论家与用户评分趋势分析工具
• 游戏研究项目的内部数据集

搜集汇总

背景与挑战

背景概述

Unofficial Metacritic API 是一个非官方的编程接口，提供对 Metacritic 网站元数据的访问，涵盖元评分、用户评分、评论数量、发布日期及平台适用性等结构化信息。该 API 适用于需要自动化获取评测数据的应用、仪表盘及研究工具。