Taobao Tmall List Product Comments
Retrieve product reviews for a Taobao or Tmall item using its product ID (itemId, required string). Choose a page with page (integer, default 1) and a sorting mode with orderType: feedbackdate for feedback-date sorting (default) or general for general sorting. The response includes a status code (code), query results (data), a message (message), and recordTime. The review fields within data and any pagination metadata are not specified; one page should not be treated as the full review history.
Pricing
| Condition | Charge |
|---|---|
| Each call | 34.92 credits/call |
Each call queries reviews for the specified product and page. A single page does not represent the complete review history; retrieving other pages requires additional calls, each charged separately.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | 用于分页的页码。 | 1 |
itemId | string | Yes | 淘宝/天猫上的唯一商品标识符(商品ID)。 | — |
orderType | enum (feedbackdate | general) | No | 结果集的排序方式。 | feedbackdate |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_taobao_tmall_list_product_comments' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"itemId": "902810466660",
"orderType": "feedbackdate",
"page": 2
}
}'{
"code": 0,
"data": {
"comments": [
{
"append": null,
"appendCanExplainable": false,
"appendList": [],
"auction": {
"aucNumId": "902810466660",
"auctionPic": "",
"link": "//item.taobao.com/auction/item_detail.htm?item_num_id=902810466660",
"sku": "颜色分类:R(不可开椒体验装X2)",
"thumbnail": "",
"title": ""
},
"award": "",
"status": 0
}
],
"currentPageNum": 2,
"hasAppendCount": 1,
"hasMediaCount": 0,
"hasNextPage": false,
"keywords": []
},
"message": null,
"recordTime": "2026-11-11T10:55:42.421244318",
"requestParams": {
"body": null,
"query": {
"itemId": "902810466660",
"orderType": "feedbackdate",
"page": "2"
}
}
}This example shows part of the response. Copied content is valid JSON.


