---
title: "产品口碑：评价列表 + 评分聚合"
method: GET
path: "/v1/products/{id}/ratings"
tags: ["检索"]
---

# 产品口碑：评价列表 + 评分聚合

`GET /v1/products/{id}/ratings`

## Request

- Base URL: `https://api.opcmenu.com`
- URL: `https://api.opcmenu.com/v1/products/{id}/ratings`
- Auth: none declared

尽调 / 选品场景：拉某产品的用户评价与评分分布。典型组合链：searchProducts 找到产品 → getProduct 看介绍 → getProductRatings 看真实口碑（平均分、1-5 星分布、逐条评价）， agent 可据此替用户汇总「值不值得用 / 值不值得聊合作」的判断依据。 summary.avg 为平均分（保留 1 位小数），summary.distribution 为各星级条数。

## Path parameters

- `id` string, required

## Query parameters

- `sort` 'recent' | 'helpful'
- `limit` integer
- `cursor` string

## Response `200`

评价列表与聚合摘要

- object
  - `ok` boolean
  - `data` object
    - `summary` RatingSummary
      - `targetType` string
      - `count` integer: 评价总数
      - `avg` number, nullable: 平均分（1 位小数）
      - `distribution` object: 各星级条数（key 为 1-5）
    - `items` RatingCard[]
      - `id` string
      - `score` integer, nullable: 评分 1-5
      - `body` string, nullable: 评价正文
      - `relation` string, nullable: 与产品的关系（用过/合作过等）
      - `tags` string[]
      - `helpfulCount` integer: 「有用」票数
      - `createdAt` string, date-time
      - `author` object
        - `id` string
        - `nickname` string
        - `avatarUrl` string, nullable
        - `isVerified` boolean
    - `nextCursor` string, nullable

---

[API](https://skmtc.dev/opcmenu/apis/opc-api.md) · [All operations](https://skmtc.dev/opcmenu/apis/opc-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opcmenu/apis/opc-api/revisions/ccdee07fb248?raw)