Theme: A practical technical guide to accessing Taobao and 1688 product review data via official APIs, including usage scenarios, core parameters, stability best practices, and standard JSON response structure for enterprise systems.
1. Overview
Reputation monitoring and sentiment analysis
Competitive product research
Product quality improvement
Content generation for storefronts or recommendation systems
Business intelligence and rating statistics
2. Core API Interfaces
taobao.item.review.get– Get Taobao product review list1688.item.review.get– Get 1688 wholesale product reviewstaobao.item.review.detail.get– Get single review details
page_no, page_sizeFilter: good / neutral / bad reviews, with or without images3. Common Request Parameters
num_iid– Product ID (required)page_no– Page numberpage_size– Items per page (max 50)rate_type– Filter: all / good / neutral / badhas_pic– Filter reviews with images only
4. Standard JSON Response Example
"item_review_get_response": {
"total_results": 8652,
"page_no": 1,
"page_size": 20,
"reviews": [
{
"review_id": 10230456789012,
"user_nick": "user_anonymized",
"is_anonymous": true,
"content": "Great quality, fast delivery, fits very well.",
"score": 5,
"created": "2026-05-20 14:22:35",
"like_count": 86,
"sku_info": {
"properties_name": "Color: White | Size: L"
},
"pic_urls": [
"https://img.taobao.com/review/1.jpg",
"https://img.taobao.com/review/2.jpg"
],
"additional_review": {
"content": "Washed several times, no fading.",
"created": "2026-05-23 09:11:22"
},
"seller_reply": {
"content": "Thank you for your trust!",
"created": "2026-05-20 16:40:12"
}
}
],
"request_id": "req_20260525102233012345"
}}5. Key Fields Explanation
review_id– Unique review ID (for deduplication)content– User review textscore– Rating from 1 to 5created– Review publish timesku_info– Corresponding product specificationpic_urls– Review image attachmentsadditional_review– Follow-up/second reviewseller_reply– Official store replytotal_results– Total reviews availablerequest_id– For log tracing and troubleshooting
6. Enterprise Stability & Best Practices
Control QPS and request frequency to avoid rate-limiting
Use exponential backoff retry for timeouts and 5xx errors
Validate score range (1–5), non-empty content, and valid image URLs
Cache frequent queries with Redis to reduce API calls
Use incremental synchronization based on
createdtimeLog all requests, errors, and request_ids for monitoring
Implement service degradation when API is unstable
