# レビューと評価

> Star ratings and written reviews of products, with moderation, store replies and imported reviews.

> Markdown version of https://kanorio.com/ja/developers/products/reviews. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp
>
> Translated from the English original: https://kanorio.com/en/developers/products/reviews.md

Status: **Partial**

レビュー機能では、顧客が購入した商品に対して評価や感想を記述できます。レビューは特定の対象を指し、その対象には集計された評価と表示設定のみが保存されます。

## コアオブジェクト

- **レビュー:** 検証済みの購入者による評価とテキスト、またはインポートされたレビューです。購入者のレビューは承認または拒否されます。インポートされたレビューは削除も可能です。
- **返信:** レビューに対するストア側の公開回答です。
- **設定:** 商品ごとの設定です。レビューの有効・無効、表示しきい値、開始時の過去の評価などを設定します。

## APIの役割

- 公開されたレビューや評価の概要は Content Delivery API で読み取るか、`<kanorio-reviews>` および `<kanorio-rating>` を使用してレンダリングします。
- 顧客は Customer API を通じて自身のレビューを作成・編集できます。
- モデレーション、返信、インポート、設定の変更は Management API で行います。
- Webhooks は、レビューの送信、公開、返信を報告します。

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Reviews & ratings for products (services when bookings ship) | Partial | Management API `reviews.*` (list, get, approve, reject, reply, import, delete_imported, settings.get/update); Delivery `GET /reviews?target=` and `GET /reviews/summary?target=`; Customer API `GET/POST/PATCH /customer/reviews` | `<kanorio-reviews>` and `<kanorio-rating>` | `/store/products/reviews` and the hosted product page | `reviews.submitted`, `reviews.published`, `reviews.replied` |
| Photo or video attachments on reviews | Not offered | — | — | — | — |
| Multi-step moderation workflows and reviewer assignment | Not offered | — | — | — | — |
| Store-wide mixed review wall | Not offered | — | — | — | — |
| Google Product Ratings feed generation | Not offered | — | — | — | — |
| Hiding or auto-rejecting reviews by star rating | Not offered | — | — | — | — |

## API reference

- Management API: [Reviews](https://kanorio.com/en/developers/management-api/reviews) (9 operations)
- Content Delivery API: [Reviews](https://kanorio.com/en/developers/delivery-api/reviews) (2 operations)
- Customer API: [Reviews](https://kanorio.com/en/developers/customer-api/reviews) (3 operations)

## Webhook events

- `reviews.submitted`: Fired when a buyer submits or edits a review (it is pending moderation).
- `reviews.published`: Fired when a review becomes public: approved by the store, or imported.
- `reviews.replied`: Fired when the store posts or replaces its public reply to a review.

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-reviews>`: Published reviews for a product or service with the rating summary, verified badges, replies and load more.
- `<kanorio-rating>`: Compact star rating and review count for a product or service.

## Recent changes

- 2026-10-28: Reviews: moderate, reply, import and settings

Full changelog: https://kanorio.com/en/developers/changelog

## For site owners

Dashboard help: https://kanorio.com/ja/help/reviews