Taobao & 1688 Product Review API: Enterprise Technical Overview & JSON Response

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

Taobao and 1688 Product Review APIs allow developers and enterprises to programmatically obtain user feedback, ratings, images, 追加评论 (additional reviews), and seller replies.

These APIs are widely used for:

• Reputation monitoring and sentiment analysis
• Competitive product research
• Product quality improvement
• Content generation for storefronts or recommendation systems
• Business intelligence and rating statistics

The APIs return structured, clean JSON data and support pagination, filtering by rating type, and image reviews.

2. Core API Interfaces

Common standard API methods for review data:

• taobao.item.review.get – Get Taobao product review list
• 1688.item.review.get – Get 1688 wholesale product reviews
• taobao.item.review.detail.get – Get single review details

Authentication: AppKey + AppSecret signature

Format: JSON (recommended) / XML

Protocol: HTTPS

Pagination: page_no, page_size

Filter: good / neutral / bad reviews, with or without images

3. Common Request Parameters

• num_iid – Product ID (required)
• page_no – Page number
• page_size – Items per page (max 50)
• rate_type – Filter: all / good / neutral / bad
• has_pic – Filter reviews with images only

4. Standard JSON Response Example

json

{
  "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 text
• score – Rating from 1 to 5
• created – Review publish time
• sku_info – Corresponding product specification
• pic_urls – Review image attachments
• additional_review – Follow-up/second review
• seller_reply – Official store reply
• total_results – Total reviews available
• request_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 created time
• Log all requests, errors, and request_ids for monitoring
• Implement service degradation when API is unstable

7. Summary

Taobao and 1688 Product Review APIs provide reliable, structured, and compliant access to user-generated content for enterprise applications.

With proper pagination, filtering, error handling, and caching, businesses can build stable review analysis, monitoring, and business intelligence systems to support data-driven operations.