EtshopAPI Platform
中文 / EN
接口参考

商品评论列表 API

GET/v1/product/comment-analysis-list
免费·api.etshop.ai/open-api
Credits 消耗规则

计费规则:店铺/商品列表与热销榜每返回 1 条扣 1 Credit,店铺详情每次扣 2 Credits;详情、趋势、每日数据、评论免费(需 3 天内在列表或详情中返回过)。关键词搜索每个词扣 1 Keyword Credit,30 天内同一个词免费。店铺监控每个店铺扣 1 Monitor Credit,监控 30 天,停止后不退还。空结果不扣费,服务器错误自动退还。

请求头

AUTHORIZATIONAuthorization: {API Key}
CONTENT-TYPEapplication/json
ACCEPTapplication/json

请求示例

cURL
curl --location --request GET 'https://api.etshop.ai/open-api/v1/product/comment-analysis-list?product_id=1284567890&with_photo=1&order_by=date&direction=desc&current_page=1&page_size=2' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 8 项

按参数标注的位置传入请求。

参数 类型 说明
product_id
query · 必填
integer 商品 ID
review_star
query · 可选
integer 按评分筛选(评分向下取整):5、4、3、2、1
sku
query · 可选
integer SKU 图片 ID,只返回购买了该款式的评论
with_photo
query · 可选
integer 传 1 只返回带买家晒图的评论,0 不限
current_page
query · 可选
integer 页码,最小 1,默认 1
page_size
query · 可选
integer 每页条数,范围 1-100,默认 20
order_by
query · 可选
string 排序字段:date(评论时间)、rating(评分);不传时按最新收录排序
direction
query · 可选
string 排序方向:desc 降序(默认)、asc 升序

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": 58420917,
                "img_url": "https://i.etsystatic.com/iap/8d2c41/6345678901/iap_fullxfull.6345678901_m4n7q2rs.jpg?version=0",
                "date": 1794021600,
                "buyer_real_name": "Emily Carter",
                "buyer_avatar_url": "https://i.etsystatic.com/iusa/2b7e19/104582736/iusa_75x75.104582736_3kfz.jpg?version=0",
                "rating": 5,
                "review": "Beautiful, soft linen and the color is exactly as pictured. Shipping to the US took just over a week."
            },
            {
                "id": 58377205,
                "img_url": "https://i.etsystatic.com/iap/51f0b3/6334567890/iap_fullxfull.6334567890_h8w1x5te.jpg?version=0",
                "date": 1793761200,
                "buyer_real_name": "Sophie",
                "buyer_avatar_url": "https://www.etsy.com/images/avatars/default_avatar_75x75.png",
                "rating": 4,
                "review": "Lovely quality. It wrinkles a lot, but that is expected with linen."
            }
        ],
        "page": {
            "page_count": 156,
            "current_page": 1,
            "total_count": 312,
            "page_size": 2
        }
    },
    "credits": {
        "type": "default",
        "remaining_credits": 196531,
        "consumed_credits": 0,
        "total_credits": 196531
    }
}
文档中的示例数据

返回数据结构

名称 类型 必选 约束 说明
» code integer true none 业务状态码
» message string true none 响应消息
» data object true none 响应数据
»» data [object] true none 评论列表
»»» id integer true none 评论 ID
»»» rating number true none 评分(1–5,个别评论可能带小数)
»»» review string true none 评论内容
»»» date integer true none 评论时间(Unix 时间戳,秒)
»»» img_url string true none 买家晒图链接,没有晒图时为空字符串
»»» buyer_real_name string true none 买家名称
»»» buyer_avatar_url string true none 买家头像链接
»» page object true none 分页信息
»»» page_count integer true none 总页数
»»» current_page integer true none 当前页码
»»» total_count integer true none 总条数
»»» page_size integer true none 每页条数
» credits object true none 本次请求的 Credits 信息,见计费规则
»» type string true none Credits 类型,本接口为 default
»» remaining_credits integer true none 本次请求后剩余的 Credits
»» consumed_credits integer true none 本次请求消耗的 Credits,本接口为 0
»» total_credits integer true none 本次请求前的 Credits 余额(remaining_credits + consumed_credits)
来自现有接口目录与文档 · 支持接口名称和地址搜索