Taobao & Tmall Product Reviews API (V3) – JustOneAPI

Version: V3

Status: Production-ready (Healthy)Endpoint: GET /api/taobao/get-item-comment/v3Data Format: JSONPlatform: Unified for Taobao + Tmall

1. Overview

The Taobao & Tmall Product Reviews API (V3) from JustOneAPI provides structured, real-time user review data for any Taobao or Tmall item. It unifies both platforms into a single interface, so you don’t need separate logic for Taobao vs Tmall.

Common use cases:

• Competitor review analysis & sentiment monitoring
• Product quality research and rating statistics
• Reputation tracking & negative review alerting
• E-commerce BI dashboards and review scraping at scale
• Content generation (e.g., top pros/cons from reviews)

2. Request Parameters (GET)

All parameters are passed as query strings.

表格

3. Full JSON Response Example (V3)

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "itemId": "681234567890",
    "total": 1258,
    "page": 1,
    "pageSize": 20,
    "reviews": [
      {
        "reviewId": "152345678901234567",
        "userNick": "t***8",
        "isAnonymous": true,
        "score": 5,
        "content": "Quality is very good, delivery fast, will buy again.",
        "created": "2026-05-20 14:22:35",
        "likeCount": 42,
        "skuInfo": "Color: Black | Size: XL",
        "picUrls": [
          "https://img01.taobaocdn.com/imgextra/i1/xxx.jpg",
          "https://img02.taobaocdn.com/imgextra/i2/xxx.jpg"
        ],
        "additionalReview": {
          "content": "Used for one month, still perfect.",
          "created": "2026-05-23 09:11:22"
        },
        "sellerReply": {
          "content": "Thank you for your support!",
          "created": "2026-05-20 16:40:12"
        }
      }
    ],
    "hasNext": true
  },
  "requestId": "req-20260526-xxx"
}

4. Key Fields Explained

• reviewId: Unique ID for deduplication
• score: 1–5 star rating
• content: Main review text
• created: Review time (UTC+8)
• skuInfo: Exact variant (color/size)
• picUrls: Array of review photos
• additionalReview: Follow-up review (追评)
• sellerReply: Official store reply
• hasNext: Pagination flag (simpler than calculating last page)

5. Error Codes

表格

6. Usage Example (Python)

python

运行

import requests
TOKEN = "your_token"
ITEM_ID = "681234567890"
URL = f"https://docs.justoneapi.com/api/taobao/get-item-comment/v3?token={TOKEN}&itemId={ITEM_ID}&page=1&pageSize=10&orderType=feedbackdate"
resp = requests.get(URL)
print(resp.json())

7. Why Use JustOneAPI V3

• Unified Taobao + Tmall → one endpoint for both
• Simpler pagination → hasNext boolean
• Clean JSON → no messy nested structures
• Built-in filtering → rating, images, date
• Stable & monitored → public health status