# Shopee API - Get Shopee product review list

## API Overview

- Review list
- Number of reviews
- Review content
- Review images/videos
- Review time

## API URL

`GET https://api.tmapi.io/shopee/item/ratings`

## Request Parameters

### Query

| Field | Type | Explanation | Required |
| --- | --- | --- | --- |
| site | string | Region name abbreviation, for example, Thailand is 'th'.<br/>Optional values: `my`, `th`, `ph`, `id`, `vn`, `sg`, `tw`, `br`, `mx`, `co`, `cl` | true |
| item_id | integer | Product ID | true |
| shop_id | integer | Shop ID | true |
| rate_filter | string | Optional values: `with_comments`, `with_media`, `local_review` | false |
| rate_star | string | Optional values: `1`, `2`, `3`, `4`, `5` | false |
| page | integer | Page number<br/>Default value: 1 | false |
| pageSize | integer | Default value: 6 | false |

## Security Auth

> Please go to [Console-Account Center](https://console.tmapi.io/account/center) to get your apiToken.

> Add your apiToken to the request parameters. Please refer to the examples below.

## Request Example

```bash

curl --request GET 'https://api.tmapi.io/shopee/item/ratings?apiToken=xxxxxx&site=&item_id=9385530978&shop_id=140500145&page=1&pageSize=6'

```

## Response Example

```json

{
  "code": 200,
  "msg": "success",
  "data": {
    "item_id": 18115264874,
    "shop_id": 423689121,
    "site": "th",
    "page": 1,
    "page_size": 3,
    "rate_filter": "",
    "rate_star": "",
    "total_count": 324,
    "has_next_page": true,
    "ratings": [
      {
        "anonymous": true,
        "author_username": "r*****8",
        "author_userid": 7928050,
        "comment": "คุณภาพ:ใช้งานได้ดีนะ\nการใช้งาน:ขับนุ่มเงียบ\n\nประกอบไม่ยาก แม่ประกอบเองได้ ไม่ยุ่งยาก ทางร้านให้คำแนะนำดี ไม่เข้าใจตรงไหน สอบถามทางร้านได้เลย",
        "ctime": 1668063397,
        "is_hidden": false,
        "is_repeated_purchase": false,
        "like_count": 10,
        "order_id": 120382504108716,
        "rating_star": 5,
        "rating_star_detail": {
          "product_quality": 5,
          "seller_service": 5,
          "delivery_service": 5
        },
        "rating_imgs": [
          "https://cf.shopee.co.th/file/th-11134103-22110-9ub3m3jyvpjv23"
        ],
        "rating_videos": [
          "https://play-ws.vod.shopee.com/api/v4/11110103/mms/th_656af9fc-2077-45e6-a8aa-11d2054d8a28_000118.12000051668063271.mp4"
        ],
        "status": 2
      },
      {
        "anonymous": false,
        "author_username": "tangmo_1994",
        "author_userid": 313690368,
        "comment": "คุณภาพ:ดี\nการใช้งาน:ดี\n\nได้รับสิน​ค้าแล้วค่ะ​ ร้านใช้เวลาแพ็ค3วันแต่ขนส่งเร็วมาก​2วันถึง  ทีแรกสั่งสีฟ้าขาวแต่หมดทางร้านทักมาบอกเปลี่ยนสีเลยได้สีแดง เบื้องต้นรถใช้งานได้ปกติขาดน้อตตะกร้าแค่ตัวเดียวมีรอยถลอก1จุดแต่รับได้ค่ะเล็กน้อย ร้านค้าบริการดีมากตอบแชทเร็วแก้ปัญหา​ดีมากชอบมากค่ะ ไว้โอกาสหน้าจะอุดหนุนอีกนะคะ🥰🥰",
        "ctime": 1669083610,
        "is_hidden": false,
        "is_repeated_purchase": false,
        "like_count": 2,
        "order_id": 122216885174203,
        "rating_star": 5,
        "rating_star_detail": {
          "product_quality": 5,
          "seller_service": 5,
          "delivery_service": 5
        },
        "rating_imgs": [
          "https://cf.shopee.co.th/file/th-11134103-22110-xlcn598mq7jv0e"
        ],
        "rating_videos": [
          "https://play-ws.vod.shopee.com/c3/98934353/103/A3oxOA5oALCkfnQSEZwKACc.mp4"
        ],
        "status": 2
      },
      {
        "anonymous": false,
        "author_username": "nuikuma",
        "author_userid": 34579066,
        "comment": "ประหยัดกว่าเจ้าอื่น 200-400 บาท ครับถ้าเทียบรุ่นถอดแบตแต่ ค่าส่วนต่างไปจ่ายให้ช่างและค่าเครื่องมือครับ ส่งวิดีโอมา ใช้แบบงงๆ ครับไม่มีเครื่องมืออะไรเลยครับ มา งงกไก่ตาแตก แต่ตอบเร็วครับ แต่ไม่มีเครื่องอะไรให้เลยเหมาะกับ ขายร้านจักรยานขายต่อครับ",
        "ctime": 1668914356,
        "is_hidden": false,
        "is_repeated_purchase": false,
        "like_count": 1,
        "order_id": 121833468272141,
        "rating_star": 5,
        "rating_star_detail": {
          "product_quality": 5,
          "seller_service": 5,
          "delivery_service": 5
        },
        "rating_imgs": [
          "https://cf.shopee.co.th/file/th-11134103-22110-tekhanm2x4jve2"
        ],
        "rating_videos": [
          "https://play-ws.vod.shopee.com/c3/98934353/103/A3oxOEJMAERPK0wSEY8BACc.mp4"
        ],
        "status": 2
      }
    ]
  }
}

```