Amazon

Amazon API

按 Amazon 国家站点查商品与评论,凭含 ASIN 的链接核对单品,另可读取类目畅销榜和卖家线索;榜单排名不是销量,接口不保存监控历史。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 amazon,action 填下方列表里的能力名,例如 search。

  • 10 个能力
  • 每千次 $1.39 起
  • 失败和空结果都不收费
  • 24h 健康值 90%

平台运行状态

24h 健康值
90%
健康

30 天趋势

Amazon 能力清单

能力做什么单价24 小时运行状态
关键词搜索search把国家站点与搜索词分开传,建立对应市场的商品清单。$2.24 / 千次正常
主页或对象详情profile把具体商品链接交给 profile,读取该商品的描述与公开状态。$1.39 / 千次健康 · 健康值 91%
评价reviews用商品链接和对应国家站点读取评论,避免把同一 ASIN 的不同市场混在一起。$1.39 / 千次正常
畅销榜bestsellers用 bestsellers 读取类目榜单,把榜单位置与关键词搜索结果分开分析。$1.39 / 千次正常
卖家搜索sellers从商品或卖家相关页面读取公开经营资料,核对候选卖家的关联商品。$1.39 / 千次正常
关键词排名ranked_keywords用 ranked_keywords 列出一个商品在美国站搜索里排得上的关键词,看每个词的搜索量和名次。$280 / 千次正常
竞品商品product_competitors用 product_competitors 输入一个 ASIN,列出美国站上和它在相同关键词下都有排名的其他商品。$11.51 / 千次暂不可用
关键词搜索量bulk_search_volume用 bulk_search_volume 一次提交最多 20 个关键词,拿回每个词在 Amazon 美国站的月搜索量。$11.51 / 千次正常
批量商品排名概览rank_overview用 rank_overview 一次传入最多 20 个 ASIN,每件商品一行,汇总它在美国站自然结果和广告位上排得上的关键词数量。$11.51 / 千次正常
多个商品的共同关键词keyword_intersections用 keyword_intersections 传入 2–10 个 ASIN,取回这些商品在美国站都排得上的关键词,以及每件商品在该词下的名次。$11.51 / 千次暂不可用

Amazon 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价返回字段
searchkeyworddomain, lang默认 10 · 最多 50$2.24 / 千次asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · images · features · bestseller_ranks
profileurllang—$1.39 / 千次asin · title · url · brand · price · list_price · currency · rating · rating_scale · rating_count · in_stock · category · image_url · description · is_amazon_choice · seller_name · platform · images · features · bestseller_ranks
reviewsurldomain默认 20 · 最多 100$1.39 / 千次review_id · title · text · rating · rating_scale · posted_at · helpful_count · is_verified_purchase · is_vine · variant · country · url · author_name · author_id · author_avatar_url · product_asin · platform · images
bestsellerskeywordlang默认 20 · 最多 100$1.39 / 千次id · url · name · rank · price · rating · rating_scale · review_count · offer_count · category · image_url · platform
sellerskeywordlang默认 10 · 最多 50$1.39 / 千次id · url · name · business_name · phone · address · rating · rating_scale · review_count · product_asin · product_name · product_url · product_price · product_currency · product_brand · product_rating · platform
ranked_keywordsasin—默认 20 · 最多 100$280 / 千次asin · keyword · search_volume · search_rank · result_type · result_type_rank · search_result_count · ranked_at · title · url · image_url · price · currency · rating · rating_scale · rating_count · is_amazon_choice · is_bestseller · bought_past_month · total_keywords · platform
product_competitorsasin—默认 20 · 最多 100$11.51 / 千次asin · url · shared_keywords · avg_position · shared_organic_keywords · shared_organic_top10_keywords · shared_organic_search_volume · shared_sponsored_keywords · shared_sponsored_search_volume · organic_keywords · sponsored_keywords · target_asin · platform
bulk_search_volumekeywords——$11.51 / 千次keyword · search_volume · platform
rank_overviewasins——$11.51 / 千次asin · url · organic_keywords · organic_top1_keywords · organic_top3_keywords · organic_top10_keywords · organic_search_volume · sponsored_keywords · sponsored_top1_keywords · sponsored_top3_keywords · sponsored_top10_keywords · sponsored_search_volume · platform
keyword_intersectionsasins—默认 20 · 最多 100$11.51 / 千次keyword · search_volume · ranked_at · rankings · total_keywords · platform

怎么调用 Amazon 主页或对象详情 API?

profile

使用 platform="amazon"、action="profile" 调用“主页或对象详情”能力;返回单个对象,主要包含 asin、title、url、brand、price、list_price 等 20 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon profile 的参数分别是什么意思?

url必填
Amazon 商品链接,例如 https://www.amazon.com/dp/<ASIN>。reviews 从 /dp/、/gp/product/ 或 /product-reviews/ 路径提取 10 位大写字母/数字 ASIN;不能用店铺首页代替。profile 在这里指商品详情,不是用户资料。

Amazon 将 ASIN 定义为 10 位字母数字商品标识,并说明可以在商品详情链接的 /dp/ 后找到它。官方来源:Amazon:ASIN 定义与查找方法来源核查:

lang可选
页面内容语言。en / ja 等为英文 / 日文;简体和繁体中文使用 zhcn / zhtw,不是通用 zh。只接受当前接口列出的语言代码,选择语言不等于切换国家站点。
查看全部 24 个允许值

arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon 返回字段与含义(8)
asin
Amazon 标准识别号,站内唯一商品标识。
brand
品牌。
list_price
划线原价。
in_stock
是否有货。
seller_name
卖家名称。
is_amazon_choice
是否有 Amazon's Choice 标。
features
商品页上的卖点要点列表(search / profile),按页面原文;没有时没有这个字段。
bestseller_ranks
Best Sellers 排名列表(search / profile):每项含 rank(名次)和 category(所在类目),同一商品在不同类目的名次分开列;是采集时的名次,不是销量。

怎么调用 Amazon 评价 API?

reviews

使用 platform="amazon"、action="reviews" 调用“评价”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 review_id、title、text、rating、rating_scale、posted_at 等 18 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon reviews 的参数分别是什么意思?

url必填
Amazon 商品链接,例如 https://www.amazon.com/dp/<ASIN>。reviews 从 /dp/、/gp/product/ 或 /product-reviews/ 路径提取 10 位大写字母/数字 ASIN;不能用店铺首页代替。profile 在这里指商品详情,不是用户资料。

Amazon 将 ASIN 定义为 10 位字母数字商品标识,并说明可以在商品详情链接的 /dp/ 后找到它。官方来源:Amazon:ASIN 定义与查找方法来源核查:

domain可选
评论所在的 Amazon 国家站点域名,默认 amazon.com;不要带 https://、www. 或页面路径,应与商品链接的站点一致。只支持 11 个站点:amazon.com、amazon.co.uk、amazon.de、amazon.fr、amazon.it、amazon.es、amazon.ca、amazon.com.au、amazon.in、amazon.co.jp、amazon.sg;传别的站点(例如 amazon.com.mx)扣费前回 422 invalid_value,并列出支持的站点。各站点都只能取到商品页展示的精选评论,每个商品通常十几条,取不到全部历史评论。目前美国站(amazon.com,也是不传 domain 时的默认站)取不到评论,因为这个站的评论要登录才能看,这类请求也不收费;同步调用通常返回 503 unavailable,error.reason 为 access_blocked。其他 10 个站照常;同一商品如果也在别的站卖(例如 amazon.ca、amazon.co.uk),可以改传那个站的 domain,拿到的是那个站的评论。
查看全部 11 个允许值

amazon.caamazon.co.jpamazon.co.ukamazon.comamazon.com.auamazon.deamazon.esamazon.framazon.inamazon.itamazon.sg

Amazon 返回字段与含义(9)
product_asin
商品 ASIN。
variant
规格变体。
review_id
评价 ID。
is_verified_purchase
是否为已验证购买的评价。未验证的权重应打折。
is_vine
是否为 Vine 计划评价(平台送测,需标注)。
helpful_count
评价被标「有帮助」次数。
author_name
评论人公开显示的昵称(reviews),来自评论人公开资料,可能为空。
author_id
评论人的 Amazon 公开资料 ID(reviews),可能为空。
author_avatar_url
评论人公开资料里的头像链接(reviews),可能为空或是默认头像。

怎么调用 Amazon 畅销榜 API?

bestsellers

使用 platform="amazon"、action="bestsellers" 调用“畅销榜”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、url、name、rank、price、rating 等 12 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon bestsellers 的参数分别是什么意思?

keyword必填
随接口区分:search 是商品搜索词;bestsellers 优先传 Amazon 类目畅销榜完整 URL,也接受用于拼接榜单路径的类目短名;sellers 可传商品/卖家相关页面 URL,普通文字则先构造商品搜索页,并非按卖家 ID 精确查找。

Amazon 官方说明商品可具有站点级和分类级 Sales Rank,Best Sellers 榜单按类目呈现畅销商品。EveryInfra bestsellers 的 keyword 应理解为类目短名或榜单 URL 输入,不是任意商品搜索词;该来源不证明 URL 构造、lang、聚合数量或榜单完整性。官方来源:Amazon Best Sellers:类目榜单与销售排名来源核查:

lang可选
页面内容语言。en / ja 等为英文 / 日文;简体和繁体中文使用 zhcn / zhtw,不是通用 zh。只接受当前接口列出的语言代码,选择语言不等于切换国家站点。
查看全部 24 个允许值

arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon 返回字段与含义(2)
offer_count
在售卖家数。多卖家跟卖的商品价格竞争激烈。
rank
类目排名(BSR)。Amazon 上估算销量的核心依据。

怎么调用 Amazon 卖家搜索 API?

sellers

使用 platform="amazon"、action="sellers" 调用“卖家搜索”能力;返回列表,默认 10 条、单次最多 50 条,主要包含 id、url、name、business_name、phone、address 等 17 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon 官方帮助将 third-party seller 定义为独立卖家,并说明商品页用 Sold by 标识卖家;同一商品有多个卖家时,会分别展示商品状况与价格。该来源只证明商品 offer 关联的 seller 实体,不证明 EveryInfra 可按任意关键词直接搜索卖家,也不证明电话、地址、评分或全部返回字段。官方来源:Amazon:第三方卖家与商品 offer 的关系来源核查:

Amazon sellers 的参数分别是什么意思?

keyword必填
随接口区分:search 是商品搜索词;bestsellers 优先传 Amazon 类目畅销榜完整 URL,也接受用于拼接榜单路径的类目短名;sellers 可传商品/卖家相关页面 URL,普通文字则先构造商品搜索页,并非按卖家 ID 精确查找。
lang可选
页面内容语言。en / ja 等为英文 / 日文;简体和繁体中文使用 zhcn / zhtw,不是通用 zh。只接受当前接口列出的语言代码,选择语言不等于切换国家站点。
查看全部 24 个允许值

arbncsdadeenesfrhehijaknkomlmrtanlplptsvtatetrzhcnzhtw

Amazon 返回字段与含义(8)
product_asin
商品 ASIN。
product_name
商品名称。
product_brand
品牌。
product_price
价格。
product_currency
币种。
product_rating
商品评分,5 分制。
product_url
商品链接。
business_name
卖家的注册企业名。

怎么调用 Amazon 关键词排名 API?

ranked_keywords

使用 platform="amazon"、action="ranked_keywords" 调用“关键词排名”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 asin、keyword、search_volume、search_rank、result_type、result_type_rank 等 21 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon ranked_keywords 的参数分别是什么意思?

asin必填
要查的商品 ASIN,一个 10 位大写字母/数字(例如 B0C2JXSHSK),不收列表。只查美国站;不是每个商品都有关键词排名数据,没有数据时返回空结果、不扣费。
Amazon 返回字段与含义(12)
asin
Amazon 标准识别号,站内唯一商品标识。
is_amazon_choice
是否有 Amazon's Choice 标。
keyword
这个商品排得上的搜索关键词(ranked_keywords)。
search_volume
该关键词在美国站的月搜索量估计(ranked_keywords),是整个词的需求,不是这个商品的流量;0 表示量太小。
search_rank
这个商品在该词搜索结果页上的绝对名次,从 1 开始,自然结果和广告位一起数(ranked_keywords)。
result_type
这个名次是哪种结果(ranked_keywords):organic 自然结果,sponsored 广告位。
result_type_rank
在同一种结果(organic 或 sponsored)里排第几(ranked_keywords)。
search_result_count
该关键词在美国站的搜索结果总数(ranked_keywords),可当竞争激烈程度的参考。
ranked_at
观察到这个名次的时间,ISO 8601、UTC(ranked_keywords);不同关键词的观察时间不同,可能是几周前。
is_bestseller
观察到名次时是否带 Best Seller 标(ranked_keywords)。
bought_past_month
搜索结果页上「过去一个月已购」标记的数(ranked_keywords),是平台给的估计档位(如 1000 表示 1K+),不是这个商品的准确销量。
total_keywords
这个商品总共排得上多少个关键词(ranked_keywords),或这组商品一共有多少个共同关键词(keyword_intersections);每行相同,一次最多返回 100 个。

怎么调用 Amazon 竞品商品 API?

product_competitors

使用 platform="amazon"、action="product_competitors" 调用“竞品商品”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 asin、url、shared_keywords、avg_position、shared_organic_keywords、shared_organic_top10_keywords 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

Amazon product_competitors 的参数分别是什么意思?

asin必填
要查的商品 ASIN,一个 10 位大写字母/数字(例如 B0C2JXSHSK),不收列表。只查美国站;没有数据时返回空结果。
Amazon 返回字段与含义(11)
asin
Amazon 标准识别号,站内唯一商品标识。
shared_keywords
这个竞品和目标商品都排得上的搜索关键词个数(product_competitors),按它从多到少排。
avg_position
竞品在这些共同关键词下的平均名次(product_competitors),越小越靠前。
shared_organic_keywords
共同关键词里,竞品以自然结果出现的个数(product_competitors)。
shared_organic_top10_keywords
共同关键词里,竞品自然结果排进前 10 的个数(product_competitors)。
shared_organic_search_volume
竞品以自然结果出现的共同关键词,月搜索量合计(product_competitors)。
shared_sponsored_keywords
共同关键词里,竞品以广告位出现的个数(product_competitors)。
shared_sponsored_search_volume
竞品以广告位出现的共同关键词,月搜索量合计(product_competitors)。
organic_keywords
竞品自己全部排得上的关键词里,自然结果的个数(product_competitors,不限于共同词)。
sponsored_keywords
竞品自己全部排得上的关键词里,广告位的个数(product_competitors,不限于共同词)。
target_asin
这次查的目标商品 ASIN(product_competitors),每行相同。

怎么调用 Amazon 关键词搜索量 API?

bulk_search_volume

使用 platform="amazon"、action="bulk_search_volume" 调用“关键词搜索量”能力;返回列表,主要包含 keyword、search_volume、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

keywords 放 1–20 个关键词,只查美国站;没有搜索量数据的词不出行。

JSON
{
  "platform": "amazon",
  "action": "bulk_search_volume",
  "params": {
    "keywords": [
      "wireless headphones",
      "yoga mat",
      "portable blender"
    ]
  }
}

Amazon bulk_search_volume 的参数分别是什么意思?

keywords必填
要查的关键词,1–20 个,数组或逗号分隔的字符串,每个最多 80 个字符、10 个词;大小写不分、重复的只算一次。只查美国站。
Amazon 返回字段与含义(2)
keyword
这个商品排得上的搜索关键词(ranked_keywords)。
search_volume
该关键词在美国站的月搜索量估计(ranked_keywords),是整个词的需求,不是这个商品的流量;0 表示量太小。

怎么调用 Amazon 批量商品排名概览 API?

rank_overview

使用 platform="amazon"、action="rank_overview" 调用“批量商品排名概览”能力;返回列表,主要包含 asin、url、organic_keywords、organic_top1_keywords、organic_top3_keywords、organic_top10_keywords 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

asins 放 1–20 个 ASIN,只查美国站;一个商品一行,没有关键词数据的 ASIN 不出行。

JSON
{
  "platform": "amazon",
  "action": "rank_overview",
  "params": {
    "asins": [
      "B0C2JXSHSK",
      "B0CM8STPNH"
    ]
  }
}

Amazon rank_overview 的参数分别是什么意思?

asins必填
要查的商品 ASIN,1–20 个,数组或逗号分隔的字符串,每个是 10 位大写字母/数字。只查美国站;没有数据的 ASIN 不出行。
Amazon 返回字段与含义(11)
asin
Amazon 标准识别号,站内唯一商品标识。
organic_keywords
竞品自己全部排得上的关键词里,自然结果的个数(product_competitors,不限于共同词)。
sponsored_keywords
竞品自己全部排得上的关键词里,广告位的个数(product_competitors,不限于共同词)。
organic_top1_keywords
以自然结果排第 1 的关键词个数(rank_overview)。
organic_top3_keywords
以自然结果排进前 3 的关键词个数(rank_overview,含第 1)。
organic_top10_keywords
以自然结果排进前 10 的关键词个数(rank_overview,含前 3)。
organic_search_volume
以自然结果排得上的关键词,月搜索量合计(rank_overview)。
sponsored_top1_keywords
以广告位排第 1 的关键词个数(rank_overview)。
sponsored_top3_keywords
以广告位排进前 3 的关键词个数(rank_overview,含第 1)。
sponsored_top10_keywords
以广告位排进前 10 的关键词个数(rank_overview,含前 3)。
sponsored_search_volume
以广告位排得上的关键词,月搜索量合计(rank_overview)。

怎么调用 Amazon 多个商品的共同关键词 API?

keyword_intersections

使用 platform="amazon"、action="keyword_intersections" 调用“多个商品的共同关键词”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 keyword、search_volume、ranked_at、rankings、total_keywords、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

asins 放 2–10 个 ASIN,只查美国站;一行是这些商品都排得上的一个关键词。

JSON
{
  "platform": "amazon",
  "action": "keyword_intersections",
  "params": {
    "asins": [
      "B0C2JXSHSK",
      "B0CM8STPNH"
    ]
  }
}

Amazon keyword_intersections 的参数分别是什么意思?

asins必填
要比的商品 ASIN,2–10 个,数组或逗号分隔的字符串,每个是 10 位大写字母/数字。只查美国站;返回这些商品都排得上的关键词。
Amazon 返回字段与含义(5)
keyword
这个商品排得上的搜索关键词(ranked_keywords)。
search_volume
该关键词在美国站的月搜索量估计(ranked_keywords),是整个词的需求,不是这个商品的流量;0 表示量太小。
ranked_at
观察到这个名次的时间,ISO 8601、UTC(ranked_keywords);不同关键词的观察时间不同,可能是几周前。
total_keywords
这个商品总共排得上多少个关键词(ranked_keywords),或这组商品一共有多少个共同关键词(keyword_intersections);每行相同,一次最多返回 100 个。
rankings
这组商品各自在该关键词下的名次(keyword_intersections),按传入顺序,每项有 asin、search_rank、result_type(organic 自然 / sponsored 广告)、title、price、currency、rating、rating_count。
Amazon search 调用流程一次 Amazon search 调用的全过程:向 POST /api/v1/social 发送 platform="amazon"、action="search",以及必填参数 keyword;返回结构化 JSON,含 asin、title、url、brand、price 等字段;返回列表,单次最多 50 条,计费 $2.24 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "amazon"action: "search"keywordEveryInfra$2.24 / 千次2 · 响应 · 列表asintitleurlbrandprice
一次 Amazon search 调用的全过程:向 POST /api/v1/social 发送 platform="amazon"、action="search",以及必填参数 keyword;返回结构化 JSON,含 asin、title、url、brand、price 等字段;返回列表,单次最多 50 条,计费 $2.24 / 千次,失败与空结果不计费。

Amazon 原始字段名

EveryInfra 统一字段名

左边是 Amazon 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

Amazon 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 29 个字段名只在 Amazon 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • asin
  • is_amazon_choice
  • features
  • bestseller_ranks
  • is_vine
  • product_asin
  • offer_count
  • product_currency
  • product_brand
  • result_type
  • result_type_rank
  • is_bestseller
  • bought_past_month
  • shared_organic_keywords
  • shared_organic_top10_keywords
  • shared_organic_search_volume
  • shared_sponsored_keywords
  • shared_sponsored_search_volume

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

asin
Amazon 标准识别号,站内唯一商品标识。
title
标题。平台无标题概念时(如纯文本帖)为 null。
url
该记录在原平台上的可访问链接。
brand
品牌。
price
价格数值,不含货币符号;币种见 currency。
list_price
划线原价。
currency
价格币种代码(如 CNY、USD)。price 存在但 currency 为 null 时不要假定币种。
rating
评分。分制随平台而异,同一行的 rating_scale 给出该平台满分 (多数是 5,Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算。直接比数字会得出反的结论。
rating_scale
上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
rating_count
参与评分的人数。null 表示不公开,不等于 0。
in_stock
是否有货。
category
分类名称,取值为原平台的分类体系,未做跨平台归一。
image_url
图片链接。多图能力可能返回 image_urls 数组。
description
简介或描述,通常比 text 短。
is_amazon_choice
是否有 Amazon's Choice 标。
seller_name
卖家名称。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
images
图片链接数组,按平台展示顺序;没有图片时不出现这个字段。
features
商品页上的卖点要点列表(search / profile),按页面原文;没有时没有这个字段。
bestseller_ranks
Best Sellers 排名列表(search / profile):每项含 rank(名次)和 category(所在类目),同一商品在不同类目的名次分开列;是采集时的名次,不是销量。
review_id
评价 ID。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
helpful_count
评价被标「有帮助」次数。
is_verified_purchase
是否为已验证购买的评价。未验证的权重应打折。
is_vine
是否为 Vine 计划评价(平台送测,需标注)。
variant
规格变体。
country
国家或地区。可能是全称也可能是 ISO 代码,取决于平台,未归一。
author_name
评论人公开显示的昵称(reviews),来自评论人公开资料,可能为空。
author_id
评论人的 Amazon 公开资料 ID(reviews),可能为空。
author_avatar_url
评论人公开资料里的头像链接(reviews),可能为空或是默认头像。
product_asin
商品 ASIN。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
name
名称。用于账号/商品/商家类能力,指该对象本身的名字。
rank
类目排名(BSR)。Amazon 上估算销量的核心依据。
review_count
评价条数,用于商品/商家类能力。null 表示不公开,不等于 0。
offer_count
在售卖家数。多卖家跟卖的商品价格竞争激烈。
business_name
卖家的注册企业名。
phone
联系电话,原文透传,未做号码格式归一。
address
详细地址,原文透传。
product_name
商品名称。
product_url
商品链接。
product_price
价格。
product_currency
币种。
product_brand
品牌。
product_rating
商品评分,5 分制。
keyword
这个商品排得上的搜索关键词(ranked_keywords)。
search_volume
该关键词在美国站的月搜索量估计(ranked_keywords),是整个词的需求,不是这个商品的流量;0 表示量太小。
search_rank
这个商品在该词搜索结果页上的绝对名次,从 1 开始,自然结果和广告位一起数(ranked_keywords)。
result_type
这个名次是哪种结果(ranked_keywords):organic 自然结果,sponsored 广告位。
result_type_rank
在同一种结果(organic 或 sponsored)里排第几(ranked_keywords)。
search_result_count
该关键词在美国站的搜索结果总数(ranked_keywords),可当竞争激烈程度的参考。
ranked_at
观察到这个名次的时间,ISO 8601、UTC(ranked_keywords);不同关键词的观察时间不同,可能是几周前。
is_bestseller
观察到名次时是否带 Best Seller 标(ranked_keywords)。
bought_past_month
搜索结果页上「过去一个月已购」标记的数(ranked_keywords),是平台给的估计档位(如 1000 表示 1K+),不是这个商品的准确销量。
total_keywords
这个商品总共排得上多少个关键词(ranked_keywords),或这组商品一共有多少个共同关键词(keyword_intersections);每行相同,一次最多返回 100 个。
shared_keywords
这个竞品和目标商品都排得上的搜索关键词个数(product_competitors),按它从多到少排。
avg_position
竞品在这些共同关键词下的平均名次(product_competitors),越小越靠前。
shared_organic_keywords
共同关键词里,竞品以自然结果出现的个数(product_competitors)。
shared_organic_top10_keywords
共同关键词里,竞品自然结果排进前 10 的个数(product_competitors)。
shared_organic_search_volume
竞品以自然结果出现的共同关键词,月搜索量合计(product_competitors)。
shared_sponsored_keywords
共同关键词里,竞品以广告位出现的个数(product_competitors)。
shared_sponsored_search_volume
竞品以广告位出现的共同关键词,月搜索量合计(product_competitors)。
organic_keywords
竞品自己全部排得上的关键词里,自然结果的个数(product_competitors,不限于共同词)。
sponsored_keywords
竞品自己全部排得上的关键词里,广告位的个数(product_competitors,不限于共同词)。
target_asin
这次查的目标商品 ASIN(product_competitors),每行相同。
organic_top1_keywords
以自然结果排第 1 的关键词个数(rank_overview)。
organic_top3_keywords
以自然结果排进前 3 的关键词个数(rank_overview,含第 1)。
organic_top10_keywords
以自然结果排进前 10 的关键词个数(rank_overview,含前 3)。
organic_search_volume
以自然结果排得上的关键词,月搜索量合计(rank_overview)。
sponsored_top1_keywords
以广告位排第 1 的关键词个数(rank_overview)。
sponsored_top3_keywords
以广告位排进前 3 的关键词个数(rank_overview,含第 1)。
sponsored_top10_keywords
以广告位排进前 10 的关键词个数(rank_overview,含前 3)。
sponsored_search_volume
以广告位排得上的关键词,月搜索量合计(rank_overview)。
rankings
这组商品各自在该关键词下的名次(keyword_intersections),按传入顺序,每项有 asin、search_rank、result_type(organic 自然 / sponsored 广告)、title、price、currency、rating、rating_count。

请求填写示例

这里传商品检索词;指定商品评价请使用 reviews 和商品链接。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

amazon_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"amazon","action":"search","params":{"keyword":"coffee grinder"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "asin": null,
  "title": null,
  "url": null,
  "brand": null,
  "price": null,
  "list_price": null,
  "currency": null,
  "rating": null,
  "rating_scale": null,
  "rating_count": null,
  "in_stock": null,
  "category": null,
  "image_url": null,
  "description": null,
  "is_amazon_choice": null,
  "seller_name": null,
  "platform": null,
  "images": null,
  "features": null,
  "bestseller_ranks": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

按 Amazon 国家站点做商品调研

把国家站点与搜索词分开传,建立对应市场的商品清单。

查看 search 的 domain 参数
  • domain 填 amazon.com、amazon.co.uk 等域名,不带协议或路径;结合 asin、title、price、currency 与 rating_count 比较结果。
  • lang 只控制页面语言,不代替国家站点;币种或价格缺失时不要按站点名称自行补值。

按 ASIN 核对 Amazon 商品资料

把具体商品链接交给 profile,读取该商品的描述与公开状态。

查看 profile 的 url 参数
  • url 使用包含 ASIN 的商品链接,结合 asin、brand、description、price 与 in_stock(不是库存件数)核对目标。
  • profile 在这里是商品详情,不是买家或卖家主页;in_stock 不是库存件数,接口也不提供库存锁定。

Amazon 商品评论 API 如何按国家站点和 ASIN 整理评价?

用商品链接和对应国家站点读取评论,避免把同一 ASIN 的不同市场混在一起。

查看 reviews 的 domain 参数
  • 非美国商品的 reviews 应显式传与链接一致的 domain(URL 中的国家站点);结合 product_asin、text、rating、variant 与 posted_at 归档。
  • URL 中的国家站点不会自动代替 domain 的默认值;本接口当前未公开评论 sort 参数,不承诺按最新评论取数;各站点都只取得到商品页展示的精选评论,每个商品通常十几条。

观察 Amazon 类目畅销榜

用 bestsellers 读取类目榜单,把榜单位置与关键词搜索结果分开分析。

查看 bestsellers 的 keyword 参数
  • keyword 优先填类目畅销榜的完整 URL;结合 rank、name、category 与 offer_count 整理榜单条目。
  • 这是类目榜单入口,不是普通商品关键词搜索;排名不等于具体销量,也不自带历史排名记录。

核对 Amazon 卖家与关联商品

从商品或卖家相关页面读取公开经营资料,核对候选卖家的关联商品。

查看 sellers 的 keyword 参数
  • 在 sellers 接口中,keyword 参数可填写相关页面的 URL;结合 business_name、product_asin 与 product_name 来核对返回对象。
  • 普通文字会走商品搜索页,不是按卖家 ID 精确查询;返回资料不代表资质认证,也不保证完整的在售商品目录。

Amazon 关键词排名 API 如何查一个 ASIN 在哪些搜索词下有排名?

用 ranked_keywords 列出一个商品在美国站搜索里排得上的关键词,看每个词的搜索量和名次。

查看 ranked_keywords 的 asin 参数
  • asin 只填一个 10 位 ASIN(如 B0C2JXSHSK),不收列表;只查美国站。每行一个关键词:search_volume 是这个词的月搜索量(整个词的需求,不是这个商品的流量),search_rank 是商品在该词结果页上的名次,result_type 分 organic 自然结果和 sponsored 广告位,ranked_at 是观察到名次的时间,不同词可能相隔几周。
  • limit 1–100,默认 20;total_keywords 给出这个商品总共排得上多少个词。不是每个 ASIN 都有关键词排名数据,没有时返回空结果、不扣费。价格、评分、徽章和 bought_past_month 是观察名次那一刻搜索结果页上的样子,bought_past_month 是平台给的估计档位,不是准确销量。

Amazon 竞品 API 如何找出和一个 ASIN 抢同一批搜索词的商品?

用 product_competitors 输入一个 ASIN,列出美国站上和它在相同关键词下都有排名的其他商品。

查看 product_competitors 的 asin 参数
  • asin 只收一个 10 位 ASIN,传列表会在扣费前被拒;没有数据时返回空结果。行按 shared_keywords 排,即两件商品共同排得上的关键词个数;avg_position 是竞品在这些共同词上的平均名次。
  • shared_organic_* 统计竞品以自然结果出现的共同词,shared_sponsored_* 统计广告位上的共同词;organic_keywords、sponsored_keywords 是竞品自己的总词数,target_asin 回显你查的商品。行里只有 ASIN 和重合指标,没有标题和价格,要看商品资料再用 profile;limit 默认 20、最多 100。

Amazon 关键词搜索量 API 一次能查多少个词的月搜索量?

用 bulk_search_volume 一次提交最多 20 个关键词,拿回每个词在 Amazon 美国站的月搜索量。

查看 bulk_search_volume 的 keywords 参数
  • keywords 收 1–20 个词,可写成数组或逗号分隔的字符串;每个词不超过 80 个字符、10 个单词,大小写不分,重复的词只算一次。
  • 每行是一个 keyword 和它的 search_volume。搜索量太低的词不出行,所以返回行数可能少于提交的词数;这个数是整个词的需求,不代表某件商品拿到的流量。

Amazon 排名概览 API 怎样批量比较多个 ASIN 的关键词覆盖面?

用 rank_overview 一次传入最多 20 个 ASIN,每件商品一行,汇总它在美国站自然结果和广告位上排得上的关键词数量。

查看 rank_overview 的 asins 参数
  • asins 收 1–20 个 10 位 ASIN,数组或逗号分隔都可以;没有关键词数据的 ASIN 不出行,不会给一行全空的记录。
  • organic_keywords 是自然结果里排得上的词数,organic_top1_keywords、organic_top3_keywords、organic_top10_keywords 分别是第 1、前 3、前 10 的词数,organic_search_volume 是这些词的搜索量合计;sponsored_ 开头的同名字段对应广告位。

Amazon 共同关键词 API 如何列出几件商品都有排名的搜索词?

用 keyword_intersections 传入 2–10 个 ASIN,取回这些商品在美国站都排得上的关键词,以及每件商品在该词下的名次。

查看 keyword_intersections 的 asins 参数
  • asins 至少 2 个、最多 10 个,个数不对会在扣费前被拒。每行一个共同 keyword,带月搜索量 search_volume 和观察时间 ranked_at;total_keywords 是共同词的总数。
  • rankings 按商品列出该词下的名次:每项有 asin、search_rank、result_type(organic 或 sponsored),以及观察那一刻的标题、价格和评分。limit 默认 20、最多 100。

Amazon 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

指南

Amazon 评论 API:怎么抓 Amazon 评论,从商品链接到有原文证据的问题清单

怎么抓 Amazon 评论:reviews 每次 $0.001389,11 个站点只给精选评论;美国站常要登录、返回 503 不扣费。附问题分类和原文证据。

阅读完整文章
Blog

Amazon 价格监控为什么误报:先确认是不是同一份报价

Amazon 商品抓取不能只存一个 price。本文结合官方目录与报价模型,说明 ASIN 变体、卖家、运费、优惠条件、缺货和观察时间怎样影响价格比较。

阅读完整文章
Blog

价格抓取怎么商业化:做一款商家愿意续费的价格监控产品

商家为什么为价格监控付费,又为什么取消订阅?从同款商品匹配、经营例外清单和调价审批出发,拆解价格数据产品的交付方式、收费单位、试点验证和续费条件。

阅读完整文章

Amazon API 常见问题

Amazon API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="amazon"、action 和 params。以 search 为例,必填 keyword,可选 domain、lang。这里传商品检索词;指定商品评价请使用 reviews 和商品链接。 Amazon 共 10 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

Amazon API 怎么收费?

每千次 $1.39 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 3 次 Amazon 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

Amazon API 一次能返回多少条数据?

Amazon 有 9 个列表接口,包括 search、reviews、bestsellers、sellers、ranked_keywords、product_competitors、bulk_search_volume、rank_overview、keyword_intersections。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

Amazon API 返回哪些字段?

当前目录为 search 列出 asin、title、url、brand、price、list_price 等 20 个字段名。按全站当前目录统计,29 个字段名只在 Amazon 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「按 Amazon 国家站点做商品调研」怎样接入 Amazon API?

把国家站点与搜索词分开传,建立对应市场的商品清单。 domain 填 amazon.com、amazon.co.uk 等域名,不带协议或路径;结合 asin、title、price、currency 与 rating_count 比较结果。 lang 只控制页面语言,不代替国家站点;币种或价格缺失时不要按站点名称自行补值。

「按 ASIN 核对 Amazon 商品资料」怎样接入 Amazon API?

把具体商品链接交给 profile,读取该商品的描述与公开状态。 url 使用包含 ASIN 的商品链接,结合 asin、brand、description、price 与 in_stock(不是库存件数)核对目标。 profile 在这里是商品详情,不是买家或卖家主页;in_stock 不是库存件数,接口也不提供库存锁定。

Amazon 商品评论 API 如何按国家站点和 ASIN 整理评价?

用商品链接和对应国家站点读取评论,避免把同一 ASIN 的不同市场混在一起。 非美国商品的 reviews 应显式传与链接一致的 domain(URL 中的国家站点);结合 product_asin、text、rating、variant 与 posted_at 归档。 URL 中的国家站点不会自动代替 domain 的默认值;本接口当前未公开评论 sort 参数,不承诺按最新评论取数;各站点都只取得到商品页展示的精选评论,每个商品通常十几条。

「观察 Amazon 类目畅销榜」怎样接入 Amazon API?

用 bestsellers 读取类目榜单,把榜单位置与关键词搜索结果分开分析。 keyword 优先填类目畅销榜的完整 URL;结合 rank、name、category 与 offer_count 整理榜单条目。 这是类目榜单入口,不是普通商品关键词搜索;排名不等于具体销量,也不自带历史排名记录。

可以先免费试用 Amazon API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 Amazon 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 10 个能力。无需信用卡。

开始调用 Amazon API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 Amazon 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策