跳到主要内容

看见评级数量,
读懂等级分布。

围绕卡牌、评级机构与分数,获取评级数量和等级分布,为卡牌详情、收藏比较与数据分析增加一个清晰的数据维度。

身份
card_id,关联已确认的卡牌目录记录
口径
grader 独立标明评级机构
分布
population 按 grade 返回 count
时间
as_of 对应本次统计快照
Card → Grade distribution返回结果

Charizard ex

Pokémon · 223/197 · Holofoil

该版本评级总数
234张
Grade 9
120 · 51.3%
Grader2026-10-01

数量的意义,来自完整的统计范围。

把机构、卡牌版本和统计时间放在一起,让每一组分布可以被理解。

先明确范围, 再查看数量。

让统计围绕同一张卡、同一种口径展开。

卡牌与版本关联

按卡牌 ID 连接系列、卡号和版本信息,将评级数量放回对应的卡牌档案,避免同名或相似卡面的统计混在一起。

保留评级机构

将机构作为每组分布的独立维度。不同机构各自展示,保留评分体系与统计来源的差异。

从一个总数, 看到每个等级。

让用户在详情页中理解分布结构。

逐级数量返回

以分数和数量组成分布数据,业务端可据此绘制柱状图、等级列表或详情卡片,突出需要比较的等级。

同范围汇总

在同一机构、卡牌与统计时间范围内组织总数。将总量与各级数量一起展示,同时保留范围信息。

统计有日期, 解读有依据。

把数据变动与数据含义分开处理。

保留统计快照

使用统计日期标记当前这组分布。后续查询或比较时,可先确认是否采用相同卡牌范围与机构,避免错读变化。

关联价格与目录

以卡牌身份连接目录资料和价格记录,在同一个详情中并列呈现不同维度,为分析提供数据基础。

让每一组数量,都有正确的展示方式。

把数据口径保留在界面中,比只展示一个数字更有价值。

01

跨机构比较

将不同机构的分布分开展示。不要把评分等级直接等同,也不要把机构数量简单相加后标记为唯一卡牌总数。

02

缺失与零值

没有记录时显示“暂无数据”;只有明确返回数量为 0,才展示为零。保留机构与日期,方便用户区分暂无覆盖和已有统计。

03

同卡多版本

先确认语言与版本,再关联等级分布。对于无法确定版本的识别结果,先让业务端完成确认,再查询对应的 评级数量数据。

把评级分布,接到卡牌详情里。

从身份匹配开始,将数量、分数与时间一起带回业务。

01

确认卡牌与机构

通过目录或识别结果取得卡牌 ID,确认版本以及需要查看的评级机构。

02

获取等级分布

查询相应范围的 评级数量数据,接收每个等级的数量、汇总信息与统计日期。

03

展示与关联

将分布渲染为等级列表或图表,并与卡牌资料、评级记录和价格信息一起展示。

在 Playground 试一次

查看请求参数和返回结果。

一组分布, 保留完整统计语境。

示例以同一张 Charizard ex 为对象,将机构、各级数量与统计日期一起返回。

身份
card_id,关联已确认的卡牌目录记录
口径
grader 独立标明评级机构
分布
population 按 grade 返回 count
时间
as_of 对应本次统计快照
查看 评级数量数据接口文档
GET /example/population
请求返回
{
  "sample": true,
  "card_id": "tcgplayer:509980",
  "grader": "GRADER",
  "population": [
    {
      "grade": 7,
      "count": 18
    },
    {
      "grade": 8,
      "count": 64
    },
    {
      "grade": 9,
      "count": 120
    },
    {
      "grade": 10,
      "count": 32
    }
  ],
  "total": 234,
  "as_of": "2026-10-01"
}

让评级数量,成为产品的一部分。

围绕相同卡牌身份,把分布带到适合它的业务场景。

01

评级卡商品详情

在商品资料旁展示对应机构与卡牌版本的等级分布,清晰标出统计日期,为买卖双方补充可理解的数量信息。

查看交易平台方案
02

收藏记录与比较

为评级卡收藏档案关联 Pop 分布,查看所持分数与其他等级的数量差异,让卡牌记录包含更多背景资料。

查看收藏管理方案
03

行情与数据分析

将等级分布与对应版本的价格信息并列查看,按机构和时间整理分析视图,不将评级数量直接转化为价格判断。

查看行情分析方案

开始接入前,你可能想了解。

还有问题?联系我们

评级数量数据代表发行总量或实际存世量吗?

不代表。Pop 描述指定范围内的评级数量与分数分布。发行总量、未评级卡牌以及实际存世量属于不同概念;重复送评等情况也可能影响数量的解读。

不同评级机构的数量可以直接相加吗?

不应把相加后的结果当作唯一卡牌总数。机构口径、卡牌范围、评分体系和重复评级情况可能不同,建议分机构展示与比较。

评级卡识别和 评级数量数据有什么区别?

评级卡识别从照片中提取卡牌、证书编号和标签文本;评级数量数据提供指定卡牌与机构的数量分布。二者可以通过卡牌身份关联,但识别结果本身不包含全部机构的统计。

没有返回某个等级,是否意味着数量为零?

不一定。缺失字段或没有数据,与明确返回零是不同状态。业务端应根据返回内容分别展示“暂无数据”和“0”,避免把未知数量绘制成零值。

可以判断一张卡牌是否稀有或值得购买吗?

Pop 可以补充评级数量这一维度,但无法单独说明发行总量、需求或价格。产品中可并列呈现目录、价格和评级分布,让使用者了解各项数据的含义。

接入前如何确认具体覆盖?

按需要的卡牌系列、版本与评级机构核对数据范围,并确认统计日期。目录中存在某张卡、或能识别其评级标签,都不能单独说明相应 评级数量数据一定可用。

聊聊你的
卡牌业务。

接入 API、申请 Key,或讨论数据需求。
告诉我们你正在构建什么,一起确定下一步。

  • 从你的场景开始

    了解产品目标、数据范围与调用需求。

  • 找到合适的接入方案

    组合识别、图像处理与数据能力。

  • 沟通试用与服务开通

    确认方案后,协助获取 API Key。

感兴趣的服务可多选

提交即表示你同意我们就本次需求与你联系。

此预览尚未连接需求提交服务。

从一张卡牌,开始调用。

在 Playground 用预设样例查看请求与返回,或联系我们获取 API Key。