> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Reviews API

> Review는 고객이 상품에 남긴 별점과 선택적인 서면 피드백으로, 상품의 스토어 페이지에 표시됩니다.

Reviews API를 사용하면 상품의 리뷰를 별점이나 생성일로 필터링하여 목록으로 조회하고, ID로 리뷰를 조회할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 요청 |
| - | - |
| [리뷰 목록 조회](https://docs.whop.com/ko/api-reference/reviews/list-reviews.md) | GET `/reviews` |
| [리뷰 조회](https://docs.whop.com/ko/api-reference/reviews/retrieve-review.md) | GET `/reviews/{id}` |
| [리뷰 삭제](https://docs.whop.com/ko/api-reference/reviews/delete-review.md) | DELETE `/reviews/{id}` |

## 속성

**id** `string` *required*

리뷰의 고유 식별자입니다.

**account** `object` *required*

이 리뷰가 작성된 대상 계정입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 계정의 고유 식별자입니다.
>
> **route** `string` *required*
>
> 계정 스토어 페이지의 URL 슬러그입니다. 예를 들어 whop.com/pickaxe의
> `pickaxe`입니다.
>
> **title** `string` *required*
>
> 고객에게 표시되는 계정의 표시 이름입니다.

**attachments** `object[]` *required*

리뷰에 첨부된 파일 및 미디어 목록입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 첨부 파일의 고유 식별자입니다.
>
> **content\_type** `string | null` *required*
>
> 업로드된 파일의 MIME 유형으로, 예를 들어 image/jpeg, video/mp4, audio/mpeg입니다.
>
> **filename** `string | null` *required*
>
> 업로드된 첨부 파일의 원래 파일 이름으로, 파일 확장자를
> 포함합니다.
>
> **url** `string | null` *required*
>
> 클라이언트에서 이 첨부 파일을 렌더링하기 위해 미리 최적화된 URL입니다. 앱에서 첨부 파일을 표시할 때 이 URL을 사용해야 합니다.

**created\_at** `string` *required*

리뷰가 생성된 시각으로, ISO 8601 타임스탬프입니다.

**description** `string | null` *required*

사용자의 상세 피드백이 담긴 리뷰 본문입니다. 설명이 제공되지 않은 경우
빈 문자열을 반환합니다.

**joined\_at** `string | null` *required*

리뷰어가 상품에 처음 가입한 시각으로, ISO 8601 타임스탬프입니다. 알 수 없으면
null입니다.

**paid\_for\_product** `boolean | null` *required*

리뷰어가 상품 대금을 지불했는지 여부입니다. 결제 상태를 알 수 없으면
null입니다.

**product** `object` *required*

이 리뷰가 작성된 대상 상품입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 상품의 고유 식별자입니다.
>
> **title** `string` *required*
>
> 상품 페이지와 검색 결과에서 고객에게 표시되는 상품의 표시 이름입니다.

**published\_at** `string | null` *required*

리뷰가 게시된 시각으로, ISO 8601 타임스탬프입니다. 알 수 없으면 null입니다.

**stars** `integer` *required*

리뷰어가 부여한 별점으로, 1에서 5 사이입니다.

**status** `string` *required*

리뷰의 검토(moderation) 상태입니다. 게시된 리뷰만 반환됩니다.

사용 가능한 옵션: `published`

**title** `string | null` *required*

리뷰의 짧은 요약 제목입니다. 리뷰어가 제목을 입력하지 않았으면
null입니다.

**updated\_at** `string` *required*

리뷰가 마지막으로 업데이트된 시각으로, ISO 8601 타임스탬프입니다.

**user** `object` *required*

이 리뷰를 작성한 사람의 사용자 계정입니다.

> [accordion] 속성
>
> **id** `string` *required*
>
> 사용자의 고유 식별자입니다.
>
> **name** `string | null` *required*
>
> 사용자의 공개 프로필에 표시되는 표시 이름입니다.
>
> **username** `string` *required*
>
> 사용자의 공개 프로필에 표시되는 고유 사용자 이름입니다.

```json Review theme={null}
{
	"id": "rev_xxxxxxxxxxxxxx",
	"title": "Worth every penny",
	"description": "Two years on and the paint still beads like the day it was coated.",
	"stars": 5,
	"status": "published",
	"paid_for_product": true,
	"created_at": "2026-09-20T18:02:00.000Z",
	"updated_at": "2026-09-20T18:02:00.000Z",
	"published_at": "2026-09-20T18:02:00.000Z",
	"joined_at": "2024-08-11T14:00:00.000Z",
	"user": {
		"id": "user_xxxxxxxxxxxxxx",
		"name": "Dana Whitfield",
		"username": "danawhitfield"
	},
	"attachments": [
		{
			"id": "file_xxxxxxxxxxxxxx",
			"filename": "coated-hood.png",
			"content_type": "image/png",
			"url": "https://img.whop.com/uploads/coated-hood.png"
		}
	],
	"account": {
		"id": "biz_xxxxxxxxxxxxxx",
		"title": "Shine Time Auto Detailing",
		"route": "shine-time-auto-detailing"
	},
	"product": {
		"id": "prod_xxxxxxxxxxxxxx",
		"title": "Ceramic Coating Package"
	}
}
```
