| 状态码 | 说明 |
|---|---|
| -1 | failed |
| 0 | success |
| 400 | 参数错误 |
| 1001 | 账户余额不足 |
| 1002 | 邮箱/手机号或密码错误 |
| 1003 | 请求频率超过上限 |
| 1004 | 邮箱或手机号已注册 |
| 1005 | 无效的 API Key |
| 1006 | 用户不存在 |
| 1007 | 登录凭证无效 |
| 1008 | 缺少 API Key |
| 1009 | 手机或邮箱已存在 |
| 1010 | 需要管理员授权 |
| 1011 | 原密码错误 |
| 1012 | 新密码不能与原密码相同 |
| 1013 | 手机号和uid不能都为空 |
| 1014 | 请填写验证码 |
| 1015 | 验证码错误或已过期 |
| 1016 | 登录失败次数过多,请输入 验证码 |
| 1017 | 请填写手机号 |
| 1018 | 请填写邮箱 |
| 1019 | 接口不存在,请检查 |
| 5000 | 服务暂时不可用,请稍后重试 |
| 5003 | 网络连接失败,请稍后重试 |
| 6001 | 修改密码失败,请稍后重试 |
| 字段路径 | 示例值 | 说明 |
|---|---|---|
data.page_id | "pimprod2057192" | 商品页面 ID |
data.page | 1 | 当前页码 |
data.paging.total_results | 42 | 总评论数 |
data.paging.pages_total | 9 | 总页数 |
data.paging.page_size | 5 | 每页条数 |
data.paging.current_page_number | 1 | 当前页码(翻页参数) |
data.paging.next_page_url | "/m/6406/l/en_US/product/pimprod2057192/reviews?paging.from=5&paging.size=5&..." | 下一页地址(翻页参数) |
data.reviews[].ugc_id | 588159821 | 用户生成内容 ID |
data.reviews[].legacy_id | 442679304 | 旧版 ID |
data.reviews[].review_id | 588159821 | 评论 ID |
data.reviews[].internal_review_id | 442679304 | 内部评论 ID |
data.reviews[].details.comments | "I love these eyeshadow quads so much i got four of them..." | 评论正文 |
data.reviews[].details.headline | "Love it!" | 评论标题 |
data.reviews[].details.nickname | "Alexis" | 评论者昵称 |
data.reviews[].details.properties | [] | 评论属性 |
data.reviews[].details.locale | "en_US" | 语言区域 |
data.reviews[].details.location | "Houston Texas" | 评论者所在地 |
data.reviews[].details.created_date | 1791208374126 | 评论创建时间(毫秒时间戳) |
data.reviews[].details.updated_date | 1791208811803 | 评论更新时间(毫秒时间戳) |
data.reviews[].details.bottom_line | "Yes" | 是否推荐(部分评论有) |
data.reviews[].details.product_page_id | "pimprod2057192" | 商品页面 ID |
data.reviews[].badges.is_staff_reviewer | false | 是否为官方员工评论 |
data.reviews[].badges.is_verified_buyer | false | 是否为已验证买家 |
data.reviews[].badges.is_verified_reviewer | false | 是否为已验证评论者 |
data.reviews[].media[] | [{"id":"586779000","uri":"//res.cloudinary.com/...","type":"image",...}] | 评论附带媒体 |
data.reviews[].media[].uri | "//res.cloudinary.com/powerreviews/image/upload/..." | 媒体图片地址 |
data.reviews[].media[].caption | "just a quick application test!" | 媒体说明 |
data.reviews[].metrics.helpful_votes | 0 | 有用票数 |
data.reviews[].metrics.not_helpful_votes | 0 | 无用票数 |
data.reviews[].metrics.rating | 5 | 评分 |
data.reviews[].metrics.helpful_score | 1655 | 有用度得分 |
说明: data.reviews[]数组中共有 5 条评论,上表以第一条为例说明结构,其余评论字段路径一致,仅取值不同。翻页参数为data.paging.current_page_number与data.paging.next_page_url。
{
"product": "2057192",
"page": "1",
"sort": "Newest",
"native_only": "",
"image_only": "",
"filters": "",
"search": ""
}curl --location 'https://api.yddm.com/ulta/reviews' \
--header 'x-api-key: {{X-API-KEY-QE}}' \
--header 'Content-Type: application/json' \
--data '{
"product": "2057192",
"page": "1",
"sort": "Newest",
"native_only": "",
"image_only": "",
"filters": "",
"search": ""
}'{
"code": 0,
"msg": "success",
"data": {
"cost": 100,
"balance": 751800,
"page_id": "pimprod2057192",
"page": 1,
"paging": {
"total_results": 42,
"pages_total": 9,
"page_size": 5,
"current_page_number": 1,
"next_page_url": "/m/6406/l/en_US/product/pimprod2057192/reviews?paging.from=5&paging.size=5&filters=&search=&sort=Newest&image_only=false&page_locale=en_US&native_only=true"
},
"reviews": [
{
"ugc_id": 588159821,
"legacy_id": 442679304,
"review_id": 588159821,
"internal_review_id": 442679304,
"details": {
"comments": "I love these eyeshadow quads so much i got four of them. Theyre very smooth, easily blendable, and pigmented. I recently starting getting more into korean eyeshadow because of how effortless they are on the lid but this is an expception. I really love using the shimmery shade for my cut creases.",
"headline": "Love it!",
"nickname": "Alexis",
"properties": [],
"locale": "en_US",
"location": "Houston Texas",
"created_date": 1791208374126,
"updated_date": 1791208811803,
"product_page_id": "pimprod2057192"
},
"badges": {
"is_staff_reviewer": false,
"is_verified_buyer": false,
"is_verified_reviewer": false
},
"media": [],
"metrics": {
"helpful_votes": 0,
"not_helpful_votes": 0,
"rating": 5,
"helpful_score": 1655
}
},
{
"ugc_id": 588125232,
"legacy_id": 442656290,
"review_id": 588125232,
"internal_review_id": 442656290,
"details": {
"comments": "This is just an absolutely gorgeous mini palate. I love that every shadow gets used because they are all STUNNING. I get always get compliments when I wear this palate. It makes me feel so fun and whimsicle and it's so easy to use. I can apply the shimmers with my fingers or if I want a more refined look, I'll use the matte in the crease and be more strategic with my shimmer placement. I don't give products 5 starts often, but this one deserves it. So gorg!",
"headline": "5 stars for fembot fatale",
"nickname": "Dani",
"properties": [],
"locale": "en_US",
"location": "Ocala Florida",
"created_date": 1791095781341,
"updated_date": 1791287263566,
"product_page_id": "pimprod2057192"
},
"badges": {
"is_staff_reviewer": false,
"is_verified_buyer": false,
"is_verified_reviewer": false
},
"media": [],
"metrics": {
"helpful_votes": 2,
"not_helpful_votes": 1,
"rating": 5,
"helpful_score": 1784
}
},
{
"ugc_id": 588098663,
"legacy_id": 442638593,
"review_id": 588098663,
"internal_review_id": 442638593,
"details": {
"comments": "Nice colors that go on and stay on. \nEasy to apply and good saturation.",
"headline": "Lasting color, nice saturation",
"nickname": "Laura",
"properties": [],
"locale": "en_US",
"location": "Boston, MA",
"created_date": 1791008154837,
"updated_date": 1791287267678,
"bottom_line": "Yes",
"product_page_id": "pimprod2057192"
},
"badges": {
"is_staff_reviewer": false,
"is_verified_buyer": false,
"is_verified_reviewer": false
},
"media": [],
"metrics": {
"helpful_votes": 1,
"not_helpful_votes": 0,
"rating": 5,
"helpful_score": 1240
}
},
{
"ugc_id": 587253730,
"legacy_id": 442004370,
"review_id": 587253730,
"internal_review_id": 442004370,
"details": {
"comments": "I recently bought a bunch of rem beauty items and these quads are easily my favorite. Easy to apply and blend, I use my fingers to apply the shimmers and have minimal fall out. Fembot is gorgeous and I immediately purchased earth fairy and the dangerous woman palettes. These have the best formula I've tried in a long time and the color stories actually make me excited about wearing makeup again in my early 30s (no this is not old but I worried I would feel silly wearing glitter on my eyes). Love love love, can't say enough good things about it.",
"headline": "OBSESSED!!",
"nickname": "Amanda",
"properties": [],
"locale": "en_US",
"location": "New York",
"created_date": 1789533626654,
"updated_date": 1791287275481,
"product_page_id": "pimprod2057192"
},
"badges": {
"is_staff_reviewer": false,
"is_verified_buyer": false,
"is_verified_reviewer": false
},
"media": [],
"metrics": {
"helpful_votes": 3,
"not_helpful_votes": 1,
"rating": 5,
"helpful_score": 1836
}
},
{
"ugc_id": 586778922,
"legacy_id": 441645327,
"review_id": 586778922,
"internal_review_id": 441645327,
"details": {
"comments": "I am so drawn to this brand — its product packaging, its shades, its aesthetics. It's very zilennial in its sensibilities, which makes sense given that it's Queen Ari's project. While I'm not a fan of her music, I am a huge fan of this line and especially this product. I am collecting all the Fembot products and so far have the holo stick, plumping gloss, and now this. But I couldn't be satisfied with just the one — Nightcap in Tokyo feels like the color story of the now with its rich deep berry and silvery gray-gold. You would not believe how versatile and wearable these shadows are despite their unnatural look. A pop of any of these glitters is also a welcome addition to more basic looks done with other palettes. The mattes are bases I reach for on the daily, especially that soft lavender from NiT! I smell Earth Fairy in my future!",
"headline": "I have two and I want a third",
"nickname": "Hannah",
"properties": [],
"locale": "en_US",
"location": "Seattle, WA",
"created_date": 1788771147391,
"updated_date": 1791386645886,
"bottom_line": "Yes",
"product_page_id": "pimprod2057192"
},
"badges": {
"is_staff_reviewer": false,
"is_verified_buyer": false,
"is_verified_reviewer": false
},
"media": [
{
"id": "586779000",
"uri": "//res.cloudinary.com/powerreviews/image/upload/f_auto,q_auto,h_768,w_auto/d_portal-no-product-image_ttlfpi.svg/prod/pytzpewsauigjvzgbdlj.jpg",
"helpful_votes": 0,
"not_helpful_votes": 0,
"type": "image",
"caption": "just a quick application test!"
}
],
"metrics": {
"helpful_votes": 2,
"not_helpful_votes": 1,
"rating": 5,
"helpful_score": 1961
}
}
],
"_type": "0"
}
}