获取评论接口_US/CA(v30)
POST
/sephora/reviews_us
| 状态码 | 说明 |
|---|---|
| -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 | 修改密码失败，请稍后重试 |
JSON 关键字段说明
| 字段路径 | 示例值 | 说明 |
|---|---|---|
data.Limit | 10 | 每页条数 |
data.Offset | 0 | 偏移量 |
data.TotalResults | 484 | 总评论数 |
data.Locale | "en_US" | 语言区域 |
data.Results[].Id | "411906067" | 评论 ID |
data.Results[].CID | "6183cc5f-61fb-5142-bca4-af833628df42" | 评论唯一标识 |
data.Results[].SourceClient | "sephora" | 来源客户端 |
data.Results[].Badges.verifiedPurchaser.Id | "verifiedPurchaser" | 徽章标识（已验证购买者） |
data.Results[].BadgesOrder | ["verifiedPurchaser"] | 徽章顺序列表 |
data.Results[].LastModeratedTime | "2026-10-11T03:30:48.000+00:00" | 最后审核时间 |
data.Results[].LastModificationTime | "2026-10-11T03:30:48.000+00:00" | 最后修改时间 |
data.Results[].ProductId | "2981116" | 商品 ID（SKU） |
data.Results[].OriginalProductName | "Pocket Bronze Long-Wearing Cream Bronzer sip" | 商品名称（含色号） |
data.Results[].CampaignId | "mweb" | 提交来源（mweb / iOS App） |
data.Results[].ContextDataValuesOrder | ["skinTone","eyeColor"] | 上下文数据顺序 |
data.Results[].AuthorId | "4984449979022976" | 评论者 ID |
data.Results[].ContentLocale | "en_US" | 评论语言区域 |
data.Results[].IsFeatured | false | 是否精选评论 |
data.Results[].Rating | 5 | 评分 |
data.Results[].IsRatingsOnly | false | 是否仅评分（无文字） |
data.Results[].IsRecommended | true | 是否推荐 |
data.Results[].Helpfulness | null | 有用度 |
data.Results[].TotalFeedbackCount | 0 | 总反馈数 |
data.Results[].TotalPositiveFeedbackCount | 0 | 正面反馈数 |
data.Results[].TotalNegativeFeedbackCount | 0 | 负面反馈数 |
data.Results[].ModerationStatus | "APPROVED" | 审核状态 |
data.Results[].SubmissionId | "r18723-en__17916884P5s2RD6PtK" | 提交 ID |
data.Results[].SubmissionTime | "2026-10-11T03:14:43.000+00:00" | 提交时间 |
data.Results[].ReviewText | "This product is melting into my skin..." | 评论正文 |
data.Results[].Title | "Great!" | 评论标题 |
data.Results[].UserNickname | "kailit" | 用户昵称 |
data.Results[].ContextDataValues.skinTone.Value | "fair" | 肤色值 |
data.Results[].ContextDataValues.skinTone.ValueLabel | "Fair" | 肤色显示名 |
data.Results[].ContextDataValues.skinTone.DimensionLabel | "Skin Tone" | 肤色维度名称 |
data.Results[].ContextDataValues.eyeColor.Value | "brown" | 眼睛颜色值 |
data.Results[].ContextDataValues.eyeColor.ValueLabel | "Brown" | 眼睛颜色显示名 |
data.Results[].ContextDataValues.IncentivizedReview.ValueLabel | "No" | 是否免费样品 |
data.Results[].ContextDataValues.StaffContext.ValueLabel | "No" | 是否 Sephora 员工 |
data.Results[].Photos | [] | 评论图片 |
data.Results[].Videos | [] | 评论视频 |
data.Results[].ClientResponses | [] | 官方回复 |
data.Includes.Products.<ProductId>.FamilyIds | ["P524970"] | 所属产品系列 ID |
data.Includes.Products.<ProductId>.Name | "Pocket Bronze Long-Wearing Cream Bronzer sip" | 商品名称 |
data.Includes.Products.<ProductId>.Description | "What it is: A long-wearing cream bronzer..." | 商品描述 |
data.Includes.Products.<ProductId>.ImageUrl | "https://www.sephora.com/productimages/sku/s2981116-main-zoom.jpg..." | 商品图片地址 |
data.Includes.Products.<ProductId>.Id | "2981116" | 商品 ID |
data.Includes.Products.<ProductId>.CategoryId | "cat60018" | 分类 ID |
data.Includes.Products.<ProductId>.Brand.Id | "6838" | 品牌 ID |
data.Includes.Products.<ProductId>.Brand.Name | "rhode" | 品牌名称 |
data.Includes.Products.<ProductId>.Active | true | 是否在售 |
data.Includes.Products.<ProductId>.ProductPageUrl | "https://www.sephora.com/product/pocket-bronze-..." | 商品页地址 |
data.Includes.Products.<ProductId>.UPCs[] | ["810175611341"] | UPC 条码 |
data.Includes.Products.<ProductId>.Attributes.GTIN14.Values[].Value | "00810175611341" | GTIN14 条码 |
data.Includes.Products.<ProductId>.ReviewStatistics.AverageOverallRating | 4.229038854805726 | 平均评分 |
data.Includes.Products.<ProductId>.ReviewStatistics.TotalReviewCount | 489 | 总评论数 |
data.Includes.Products.<ProductId>.ReviewStatistics.RecommendedCount | 394 | 推荐数 |
data.Includes.Products.<ProductId>.ReviewStatistics.NotRecommendedCount | 95 | 不推荐数 |
data.Includes.Products.<ProductId>.ReviewStatistics.HelpfulVoteCount | 1276 | 有用票数 |
data.Includes.Products.<ProductId>.ReviewStatistics.NotHelpfulVoteCount | 371 | 无用票数 |
data.Includes.Products.<ProductId>.ReviewStatistics.TotalPhotoCount | 107 | 图片总数 |
data.Includes.Products.<ProductId>.ReviewStatistics.TotalVideoCount | 0 | 视频总数 |
data.Includes.Products.<ProductId>.ReviewStatistics.RatingDistribution[].RatingValue | 5 | 评分值 |
data.Includes.Products.<ProductId>.ReviewStatistics.RatingDistribution[].Count | 336 | 该评分数量 |
data.Includes.Products.<ProductId>.ReviewStatistics.FirstSubmissionTime | "2026-06-15T03:21:42.000+00:00" | 首条评论时间 |
data.Includes.Products.<ProductId>.ReviewStatistics.LastSubmissionTime | "2026-10-11T03:14:43.000+00:00" | 最新评论时间 |
data.Includes.Products.<ProductId>.ReviewStatistics.ContextDataDistribution.skinTone.Values[].ValueLabel | "Fair" | 肤色分布显示名 |
data.Includes.Products.<ProductId>.ReviewStatistics.ContextDataDistribution.skinTone.Values[].Count | 82 | 该肤色评论数 |
data.Includes.Products.<ProductId>.ReviewStatistics.ContextDataDistribution.eyeColor.Values[].ValueLabel | "Brown" | 眼睛颜色分布显示名 |
data.Includes.Products.<ProductId>.ReviewStatistics.ContextDataDistribution.eyeColor.Values[].Count | 240 | 该眼睛颜色评论数 |
data.Includes.Products.<ProductId>.ReviewStatistics.ContextDataDistribution.IncentivizedReview.Values[].ValueLabel | "Yes" | 是否免费样品分布 |
data.Includes.ProductsOrder[] | ["2981116","2981066","2981074","2981041","P524970"] | 商品顺序列表 |
请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-10-12 05:20:26