Taobao & Tmall Product Reviews API (V3) – JustOneAPI
Taobao & Tmall Product Reviews API (V3) – JustOneAPI
GET /api/taobao/get-item-comment/v3Data Format: JSONPlatform: Unified for Taobao + Tmall1. Overview
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)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
token | string | ✅ | — | Your JustOneAPI access token |
itemId | string | ✅ | — | Taobao/Tmall product ID (num_iid) |
page | integer | ❌ | 1 | Page number (pagination) |
pageSize | integer | ❌ | 20 | Reviews per page (max 50) |
orderType | string | ❌ | general | feedbackdate (newest first) / general |
rateType | string | ❌ | all | all / good / neutral / bad |
hasPic | boolean | ❌ | false | Filter reviews with images only |
3. Full JSON Response Example (V3)
"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 deduplicationscore: 1–5 star ratingcontent: Main review textcreated: Review time (UTC+8)skuInfo: Exact variant (color/size)picUrls: Array of review photosadditionalReview: Follow-up review (追评)sellerReply: Official store replyhasNext: Pagination flag (simpler than calculating last page)
5. Error Codes
| Code | Meaning |
|---|---|
| 200 | Success |
| 400 | Invalid parameters |
| 401 | Token missing or invalid |
| 403 | Permission denied / quota exceeded |
| 404 | Item not found |
| 500 | Server error (retry later) |
6. Usage Example (Python)
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 →
hasNextbooleanClean JSON → no messy nested structures
Built-in filtering → rating, images, date
Stable & monitored → public health status
