Back to Details

linkfox-amazon-reviews

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Amazon Product Reviews

亚马逊商品评论工具

Fetch and analyze Amazon product reviews to help sellers extract actionable insights from customer feedback.
获取并分析亚马逊商品评论，帮助卖家从客户反馈中提取可落地的洞察。

Core Concepts

核心概念

This tool retrieves real customer reviews for a given Amazon ASIN across 15 marketplaces. You can control how many reviews to fetch per star rating (1-5 stars, up to 100 each), sort by recency or helpfulness, and apply various filters. Only one ASIN per request; for multiple ASINs, make separate calls.
本工具可针对指定亚马逊ASIN，在15个站点获取真实客户评论。你可以控制各星级（1-5星）评论的获取数量（最多100条/星级），按最新或最有用排序，还可应用多种筛选条件。每次请求仅支持一个ASIN；如需查询多个ASIN，请分开调用。

API Routing

API路由

US and non-US marketplaces use different backend endpoints. Route by marketplace:
  • US → 
    scripts/amazon_us_reviews.py
    , pass 
    marketplace: "US"
    . See 
    references/api_us.md
  • Others → 
    scripts/amazon_reviews.py
    , pass 
    domainCode: "<code>"
    . See 
    references/api.md
美国站与非美国站使用不同的后端端点，需按站点路由：
  • 美国站 → 
    scripts/amazon_us_reviews.py
    ，传入参数 
    marketplace: "US"
    。详见 
    references/api_us.md
  • 其他站点 → 
    scripts/amazon_reviews.py
    ，传入参数 
    domainCode: "<code>"
    。详见 
    references/api.md

Parameter Guide

参数指南

ParameterTypeRequiredScopeDescriptionDefault
asinstringYesAllAmazon product ASIN-
star1NumintegerNoAll1-star reviews to fetch (0-100)Non-US: 10, US: 0
star2NumintegerNoAll2-star reviews to fetch (0-100)Non-US: 10, US: 0
star3NumintegerNoAll3-star reviews to fetch (0-100)Non-US: 10, US: 0
star4NumintegerNoAll4-star reviews to fetch (0-100)Non-US: 10, US: 0
star5NumintegerNoAll5-star reviews to fetch (0-100)Non-US: 10, US: 0
sortBystringNoAll
recent
(newest) or 
helpful
(most helpful)
recent
formatTypestringNoAll
current_format
or 
all_formats
current_format
domainCodestringNoNon-USMarketplace code (see Supported Marketplaces)
ca
filterByKeywordstringNoNon-USFilter reviews by keyword (max 1000 chars)-
reviewerTypestringNoNon-US
all_reviews
or 
avp_only_reviews
(verified only)
all_reviews
mediaTypestringNoNon-US
all_contents
or 
media_reviews_only
all_contents
marketplacestringNoUSFixed value 
US
US
allStarsNumintegerNoUSReviews across all stars (0-100); active when star1-5Num are all 010
positiveNumintegerNoUS4-5 star positive reviews (0-100)0
criticalNumintegerNoUS1-3 star critical reviews (0-100)0
参数类型是否必填适用范围描述默认值
asinstring是所有站点亚马逊商品ASIN-
star1Numinteger否所有站点要获取的1星评论数量（0-100）非美国站：10，美国站：0
star2Numinteger否所有站点要获取的2星评论数量（0-100）非美国站：10，美国站：0
star3Numinteger否所有站点要获取的3星评论数量（0-100）非美国站：10，美国站：0
star4Numinteger否所有站点要获取的4星评论数量（0-100）非美国站：10，美国站：0
star5Numinteger否所有站点要获取的5星评论数量（0-100）非美国站：10，美国站：0
sortBystring否所有站点
recent
（最新）或 
helpful
（最有用）
recent
formatTypestring否所有站点
current_format
或 
all_formats
current_format
domainCodestring否非美国站站点代码（见支持的站点列表）
ca
filterByKeywordstring否非美国站按关键词筛选评论（最多1000字符）-
reviewerTypestring否非美国站
all_reviews
或 
avp_only_reviews
（仅已验证购买）
all_reviews
mediaTypestring否非美国站
all_contents
或 
media_reviews_only
all_contents
marketplacestring否美国站固定值 
US
US
allStarsNuminteger否美国站所有星级评论数量（0-100）；仅当star1-5Num均为0时生效10
positiveNuminteger否美国站4-5星好评数量（0-100）0
criticalNuminteger否美国站1-3星差评数量（0-100）0

Supported Marketplaces

支持的站点

MarketplaceCode
United States
US
Canada
ca
United Kingdom
co.uk
Germany
de
France
fr
Italy
it
Spain
es
Japan
co.jp
India
in
Australia
com.au
Brazil
com.br
Mexico
com.mx
Netherlands
nl
Sweden
se
United Arab Emirates
ae
US uses the 
marketplace
parameter; all others use 
domainCode
. Always confirm the user's intended marketplace.
站点代码
美国
US
加拿大
ca
英国
co.uk
德国
de
法国
fr
意大利
it
西班牙
es
日本
co.jp
印度
in
澳大利亚
com.au
巴西
com.br
墨西哥
com.mx
荷兰
nl
瑞典
se
阿联酋
ae
美国站使用 
marketplace
参数；其他所有站点使用 
domainCode
参数。请务必确认用户目标站点。

Usage Examples

使用示例

1. Fetch US reviews — balanced snapshot
json
{"asin": "B08N5WRWNW", "marketplace": "US", "allStarsNum": 20, "sortBy": "recent"}
2. Fetch negative reviews with keyword filter (Germany)
json
{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}
3. Fetch 5-star reviews with media (Japan)
json
{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}
1. 获取美国站评论——均衡快照
json
{"asin": "B08N5WRWNW", "marketplace": "US", "allStarsNum": 20, "sortBy": "recent"}
2. 获取带关键词筛选的德国站差评
json
{"asin": "B08N5WRWNW", "domainCode": "de", "star1Num": 30, "star2Num": 30, "filterByKeyword": "quality", "reviewerType": "avp_only_reviews"}
3. 获取日本站带媒体内容的5星评论
json
{"asin": "B08N5WRWNW", "domainCode": "co.jp", "star5Num": 50, "star1Num": 0, "star2Num": 0, "star3Num": 0, "star4Num": 0, "sortBy": "helpful", "mediaType": "media_reviews_only"}

Display Rules

展示规则

  1. Present data clearly: Show reviews grouped by star rating with key fields: rating, title, text, date, verified status, helpful count.
  2. Summarize when appropriate: For many reviews, provide a theme/pain-point summary before listing individuals.
  3. Highlight actionable insights: Call out recurring complaints in negative reviews; note praised features in positive reviews.
  4. Vine and verified labels: Clearly indicate Vine Voice and verified purchase status.
  5. Media indicators: Note when reviews include images or videos.
  6. Response normalization: US reviews return 
    rating
    as full text (e.g., "5.0 out of 5 stars") and 
    numberOfHelpful
    as string — extract numeric values for consistent display. US reviews may also include 
    attributes
    (color, size, etc.) — display them to show which variant was reviewed.
  7. Error handling: When a query fails, explain the reason based on the response message and suggest adjusting parameters.
  8. Single ASIN limitation: If the user asks about multiple ASINs, make separate requests for each.
  1. 清晰呈现数据：按星级分组展示评论，包含关键字段：评分、标题、正文、日期、验证状态、有用数。
  2. 按需总结：当评论数量较多时，先列出主题/痛点总结，再展示单条评论。
  3. 突出可落地洞察：指出差评中反复出现的投诉点；标注好评中被称赞的功能。
  4. Vine与验证标签：清晰标注Vine Voice和已验证购买状态。
  5. 媒体标识：注明评论是否包含图片或视频。
  6. 响应标准化：美国站评论返回的
    rating
    为完整文本（如"5.0 out of 5 stars"），
    numberOfHelpful
    为字符串——需提取数值以保证展示一致性。美国站评论还可能包含
    attributes
    （颜色、尺寸等）——需展示这些信息以明确评论对应的产品变体。
  7. 错误处理：当查询失败时，根据响应信息说明原因，并建议调整参数。
  8. 单ASIN限制：如果用户查询多个ASIN，需为每个ASIN单独发起请求。

Important Limitations

重要限制

  • One ASIN per request: Only a single ASIN can be queried at a time.
  • Per-star cap: Each star rating returns max 100 reviews per request.
  • Parameter scope: 
    filterByKeyword
    , 
    reviewerType
    , 
    mediaType
    are only available for non-US marketplaces; 
    allStarsNum
    , 
    positiveNum
    , 
    criticalNum
    are only available for the US marketplace.
  • No historical snapshots: Reviews are fetched in real-time.
  • Review text language: Reviews are returned in their original language as posted.
  • 每次请求仅一个ASIN：一次查询仅支持单个ASIN。
  • 单星级上限：每个星级最多返回100条评论/请求。
  • 参数范围限制：
    filterByKeyword
    、
    reviewerType
    、
    mediaType
    仅适用于非美国站；
    allStarsNum
    、
    positiveNum
    、
    criticalNum
    仅适用于美国站。
  • 无历史快照：评论为实时获取。
  • 评论语言：评论以发布时的原始语言返回。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — Tasks involving Amazon product reviews:
User SaysScenario
"Show me the reviews for this ASIN"Direct review lookup
"Get US reviews for B08N5WRWNW"Marketplace-specific lookup
"What are customers complaining about"Negative review analysis
"Get me all the 1-star reviews"Star-filtered retrieval
"Any common issues in the bad reviews"Pain point mining
"What do people like about this product"Positive review analysis
"Find reviews mentioning 'battery'"Keyword-filtered reviews (non-US)
"Show me reviews with photos"Media-filtered reviews (non-US)
"Verified purchase reviews only"Reviewer-type filtering (non-US)
"Help me analyze competitor reviews"Competitor review research
"Product improvement suggestions from reviews"Actionable insight extraction
Not applicable — Needs beyond product review data:
  • ABA search term data / keyword research (use ABA Data Explorer instead)
  • Sales estimation or revenue analysis
  • Listing copywriting or A+ content creation
  • Advertising / PPC strategy
  • Pricing strategy or profit margin calculations
Boundary judgment: If "product research" or "competitor analysis" boils down to reading customer reviews for specific ASINs, this skill applies. If it involves search volume, keyword rankings, sales estimates, or market sizing, it does not.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. Anything you believe could be improved
Call the feedback API as specified in the references. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
适用场景 —— 涉及亚马逊商品评论的任务：
用户表述场景
"帮我查看这个ASIN的评论"直接查询评论
"获取B08N5WRWNW的美国站评论"指定站点查询
"客户都在抱怨什么"差评分析
"给我所有1星评论"按星级筛选获取
"差评里有什么常见问题"痛点挖掘
"人们喜欢这个产品的哪些点"好评分析
"查找提到'battery'的评论"关键词筛选评论（非美国站）
"展示带图片的评论"媒体内容筛选评论（非美国站）
"仅展示已验证购买的评论"评论者类型筛选（非美国站）
"帮我分析竞品的评论"竞品评论研究
"从评论中提取产品改良建议"可落地洞察提取
不适用场景 —— 超出商品评论数据的需求：
  • ABA搜索词数据/关键词研究（请使用ABA Data Explorer）
  • 销量预估或营收分析
  • Listing文案或A+内容创作
  • 广告/PPC策略
  • 定价策略或利润率计算
边界判断：如果“产品调研”或“竞品分析”核心是读取特定ASIN的客户评论，则适用本技能；如果涉及搜索量、关键词排名、销量预估或市场规模测算，则不适用。
反馈机制：
当出现以下任意情况时，自动通过Feedback API上报反馈：
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不符
  3. 用户表达对本技能的不满或称赞
  4. 任何你认为可优化的内容
请按参考文档指定方式调用反馈API，不要打断用户流程。
如需更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。