产品定价API v0参考

亚马逊SPAPI

# 概述

定价的销售伙伴API帮助您以编程方式检索亚马逊市场产品的定价和报价信息.

# Version information

版本 : v0

# Operations

getPricing
getCompetitivePricing
getListingOffers
getItemOffers
getItemOffersBatch
getListingOffersBatch
<a name="paths">

# 路径

<a name="getpricing">

# getPricing

**GET /products/pricing/v0/price **

# Description

返回基于卖方SKU或ASIN.的卖方报价列表的定价信息

使用计划:

速率(每秒的请求) 突发
10 20

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
*Query *MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned. string
Query Asins
optional
A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
*Max count: 20
< string > array
Query Skus
optional
A list of up to twenty seller SKU values used to identify items in the given marketplace.
Max count : 20
< string > array
Query ItemType
required
表示是否使用ASIN值或卖方SKU值来识别物品.如果你指定Asin,响应中的信息将取决于你在Asins参数中提供的Asin列表.如果你指定Sku, 响应中的信息将取决于你在Skus参数中提供的Skus列表. enum (ItemType)
Query ItemCondition
optional
根据物品条件过滤报价清单.可能的值新的,二手的,收藏的,翻新的,俱乐部的. enum (ItemCondition
Query OfferType
optional
表示是否要求卖方的B2C或B2B报价的价格信息.默认为B2C. enum (OfferType)

# Responses

HTTP Code Description Schema
200 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetPricingResponse
400 Request有缺失或无效的参数,无法解析.
Headers :
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
401 请求的授权头格式不正确或不包含有效的令牌.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
404 指定的资源不存在.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference ID.
GetPricingResponse
429 请求的频率超过允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
500 发生了一个意外情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
503 服务器临时超载或维护.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse

<a name="getcompetitivepricing">

# getCompetitivePricing

**GET /products/pricing/v0/competitivePrice **

# Description

返回基于卖家SKU或ASIN.的卖家报价列表的竞争性价格信息

使用计划:

速率(每秒的请求) 突发
10 20

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
*Query *MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned. string
Query Asins
optional
A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
*Max count: 20
< string > array
Query Skus
optional
A list of up to twenty seller SKU values used to identify items in the given marketplace.
Max count : 20
< string > array
Query ItemType
required
表示是否使用ASIN值或卖方SKU值来识别物品.如果你指定Asin,响应中的信息将取决于你在Asins参数中提供的Asin列表.如果你指定Sku,响应中的信息将取决于你在Skus参数中提供的Skus列表.可能的值Asin, Sku. enum (ItemType)
Query CustomerType
optional
表示是否从消费者或企业买家的角度请求定价信息.默认为消费者. enum (CustomerType

# Responses

HTTP Code Description Schema
200 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetPricingResponse
400 Request有缺失或无效的参数,无法解析.
Headers :
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
401 请求的授权头格式不正确或不包含有效的令牌.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
404 指定的资源不存在.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference ID.
GetPricingResponse
429 请求的频率超过允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
500 发生了一个意外情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse
503 服务器临时超载或维护.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetPricingResponse

<a name="getlistingoffers">

# getListingOffers

**GET /products/pricing/v0/listings/{SellerSKU}/offers **

# Description

返回单个SKU列表的最低价格报价.

使用计划:

Rate (requests per second) Burst
5 10

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
*Query *MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned. string
Query ItemCondition
required
根据物品条件过滤报价清单.可能的值新的,二手的,收藏的,翻新的,俱乐部. enum (ItemCondition)
Path SellerSKU
required
识别给定市场中的一个项目. SellerSKU由卖方的SellerId限定,这个SellerId包括在你提交的每个操作中. string
Query CustomerType
optional
表示是否请求消费者或企业报价.默认为消费者. enum (CustomerType)

# Responses

HTTP Code Description Schema
200 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetOffersResponse
400 Request有缺失或无效的参数,无法解析.
Headers :
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
401 请求的授权头格式不正确或不包含有效的标记.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
404 指定的资源不存在.
Headers:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetOffersResponse
429 请求的频率超过了允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
500 发生了一个意外情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
503 服务器的临时超载或维护.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse

<a name="getitemoffers">

# getItemOffers

**GET /products/pricing/v0/items/{Asin}/offers **

# Description

返回基于ASIN.的单个项目的最低价格报价

使用计划:

Rate (requests per second) Burst
5 10

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
*Query *MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned. string
Query ItemCondition
required
根据物品条件过滤要考虑的报价清单.可能的值新的,二手的,收藏的,翻新的,俱乐部. enum (ItemCondition)
Path Asin
required
亚马逊标准识别码(ASIN)的物品. string
Query CustomerType
optional
表示请求消费者还是企业优惠.默认为消费者. enum (CustomerType

# Responses

HTTP Code Description Schema
200 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetOffersResponse
400 Request有缺失或无效的参数,无法解析.
Headers :
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
401 请求的授权头格式不正确或不包含有效的标记.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
404 指定的资源不存在.
Headers:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) .
x-amzn-RequestId (string) Unique request reference ID.
GetOffersResponse
429 请求的频率超过了允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
500 发生了一个意外情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse
503 服务器的临时超载或维护.
:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
GetOffersResponse

<a name="getitemoffersbatch">

# getItemOffersBatch

POST /batches/products/pricing/v0/itemOffers

# Description

返回基于ASIN.的一批项目的最低价格报价

使用计划:

Rate (requests per second) Burst
.5 1

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
Body getItemOffersBatchRequestBody
required
与getItemOffersBatch API调用相关的请求. GetItemOffersBatchRequest

# Responses

HTTP Code Description Schema
200 表示请求是以批处理方式运行的.检查批处理响应状态行以了解批处理请求是否成功.
:
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)
x-amzn-RequestId (string) Unique request reference ID.
GetItemOffersBatchResponse
400 Request有缺失或无效的参数,无法解析.
Headers:
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
401 请求的授权头格式不正确或不包含有效的令牌.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
404 指定的资源不存在.
Headers:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
429 请求的频率超过允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
500 发生了一个意外情况,使服务器无法完成请求.
头信息:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
503 服务器的临时超载或维护.
头信息:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors

<a name="getlistingoffersbatch">

# getListingOffersBatch

POST /batches/products/pricing/v0/listingOffers

# Description

按SKU.返回一批上市产品的最低价格报价

使用计划:

Rate (requests per second) Burst
.5 1

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划速率限制(如果有的话).上表显示了该操作的默认速率和突发值.业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值.更多信息,见使用计划和速率限制在销售伙伴API (opens new window).

# Parameters

Type Name Description Schema
Body getListingOffersBatchRequestBody
required
与getListingOffersBatch API调用相关的请求. GetListingOffersBatchRequest

# Responses

HTTP Code Description Schema
200 表示请求是以批处理方式运行的.检查批处理响应状态行以了解批处理请求是否成功.
:
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)
x-amzn-RequestId (string) Unique request reference ID.
GetListingOffersBatchResponse
400 Request有缺失或无效的参数,不能被解析.
头信息:
x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
401 请求的授权头格式不正确或不包含有效的令牌.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求).
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
:
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
404 指定的资源不存在.
Headers:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
429 请求的频率超过允许的范围.
:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
500 发生了一个意外情况,使服务器无法完成请求.
头信息:
x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作.
_注意 _ 对于这个状态代码,速率限制头已被废弃,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors
503 服务器的临时超载或维护.
头信息:
x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string) : 唯一的请求参考ID.
Errors

<a name="definitions"> : 唯一的请求参考编号.|Errors|

# Definitions

<a name="getitemoffersbatchrequest">

# GetItemOffersBatchRequest

与 getItemOffersBatch API 调用相关的请求.

Name Description Schema
requests
optional
A list of getItemOffers batched requests to run. ItemOffersRequestList

<a name="getlistingoffersbatchrequest">

# GetListingOffersBatchRequest

与getListingOffersBatch API调用相关的请求.

Name Description Schema
requests
optional
A list of getItemOffers batched requests to run. ListingOffersRequestList

<a name="listingoffersrequestlist">

# ListingOffersRequestList

一个要运行的getItemOffers分批请求的列表.

类型< ListingOffersRequest>数组

最小项目 : 1
最大项目 : 20

<a name="itemoffersrequestlist">

# ItemOffersRequestList

一个要运行的 getItemOffers 分批请求的列表.

类型< ItemOffersRequest>数组

最小项目 : 1
最大项目 : 20

<a name=" batchoffersrequestparams">

# BatchOffersRequestParams

Name Description Schema
MarketplaceId
required
A marketplace identifier. 指定返回价格的市场. MarketplaceId
ItemCondition
required
- ItemCondition
CustomerType
optional
- CustomerType

<a name=" itemoffersrequest">

# ItemOffersRequest

多态性 : 组成

Name Description Schema
uri
required
对应于打算请求的API的完整URI,包括路径参数的替换. string
method
required
与作为批量请求的一部分被调用的各个API相关的HTTP方法. HttpMethod
headers
optional
A映射额外的HTTP头,用于发送/接收单个批处理请求. HttpRequestHeaders
MarketplaceId
required
A marketplace identifier. 指定返回价格的市场. MarketplaceId
ItemCondition
required
- ItemCondition
CustomerType
optional
- CustomerType

<a name="listingoffersrequest">

# ListingOffersRequest

多态性 : 组成

Name Description Schema
uri
required
对应于打算请求的API的完整URI,包括路径参数的替换. string
method
required
与作为批量请求的一部分被调用的各个API相关的HTTP方法. HttpMethod
headers
optional
A映射额外的HTTP头,用于发送/接收单个批处理请求. HttpRequestHeaders
MarketplaceId
required
A marketplace identifier. 指定返回价格的市场. MarketplaceId
ItemCondition
required
- ItemCondition
CustomerType
optional
- CustomerType

<a name="getitemoffersbatchresponse">

# GetItemOffersBatchResponse

与getItemOffersBatch API调用相关的响应.

Name Description Schema
responses
optional
A list of getItemOffers batched responses. ItemOffersResponseList

<a name="getlistingoffersbatchresponse">

# GetListingOffersBatchResponse

与getListingOffersBatch API调用相关的响应.

Name Description Schema
responses
optional
A list of getListingOffers batched responses. ListingOffersResponseList

<a name="itemoffersresponselist">

# ItemOffersResponseList

一个getItemOffers分批响应的列表.

类型< ItemOffersResponse >数组

最小项目 : 1
最大项目 : 20

<a name="listingoffersresponselist">

# ListingOffersResponseList

一个 getListingOffers 分批响应的列表.

类型< ListingOffersResponse>数组

最小项目 : 1
最大项目 : 20

<a name=" batchoffersresponse">

# BatchOffersResponse

Name Description Schema
headers
optional
A映射额外的HTTP头,用于发送/接收单个批次请求. HttpResponseHeaders
status
optional
与响应相关的HTTP状态行.更多信息,请参考RFC 2616 (opens new window). GetOffersHttpStatusLine
body
required
用于getListingOffers和getItemOffers操作的响应模式. GetOffersResponse

<a name="itemoffersrequestparams">

# ItemOffersRequestParams

多态性 组成

Name Description Schema
MarketplaceId
required
A marketplace identifier. 指定返回价格的市场. MarketplaceId
ItemCondition
required
- ItemCondition
CustomerType
optional
- CustomerType
Asin
optional
亚马逊标准识别码(ASIN)的物品.这是作为请求参数传递的相同Asin. string

<a name="itemoffersresponse">

# ItemOffersResponse

多态性 组成

Name Description Schema
headers
optional
A映射额外的HTTP头,用于发送/接收单个批次请求. HttpResponseHeaders
status
optional
与响应相关的HTTP状态行.更多信息,请参考RFC 2616 (opens new window). GetOffersHttpStatusLine
body
required
用于getListingOffers和getItemOffers操作的响应模式. GetOffersResponse
request
required
- ItemOffersRequestParams

<a name="listingoffersrequestparams">

# ListingOffersRequestParams

多态性 组成

Name Description Schema
MarketplaceId
required
A marketplace identifier. 指定返回价格的市场. MarketplaceId
ItemCondition
required
- ItemCondition
CustomerType
optional
- CustomerType
SellerSKU
required
卖方库存单位(SKU)的物品.这是作为路径参数传递的相同SKU. string

<a name="listingoffersresponse">

# ListingOffersResponse

多态性 组成

Name Description Schema
headers
optional
A映射额外的HTTP头,用于发送/接收单个批次请求. HttpResponseHeaders
status
optional
与响应相关的HTTP状态行.更多信息,请参考RFC 2616 (opens new window). GetOffersHttpStatusLine
body
required
用于getListingOffers和getItemOffers操作的响应模式. GetOffersResponse
request
optional
- ListingOffersRequestParams

<a name="errors">

# Errors

当请求不成功时返回的错误响应列表.

Name Description Schema
errors
required
操作过程中发生了一个或多个意外的错误. ErrorList

<a name="getpricingresponse">

# GetPricingResponse

getPricing和getCompetitivePricing操作的响应模式.

Name Description Schema
payload
optional
getPricing和getCompetitivePricing操作的有效载荷. PriceList
errors
optional
在操作过程中发生一个或多个意外的错误. ErrorList

<a name="getoffersresponse">

# GetOffersResponse

getListingOffers和getItemOffers操作的响应模式.

Name Description Schema
payload
optional
getListingOffers和getItemOffers操作的有效载荷. GetOffersResult
errors
optional
在操作过程中发生一个或多个意外的错误. ErrorList

<a name="pricelist">

# PriceList

类型 < Price >数组

最大项目 : 20

<a name="getoffersresult">

# GetOffersResult

Name Description Schema
MarketplaceID
required
A marketplace identifier. string
ASIN
可选的
亚马逊标准识别码(ASIN)的物品. string
SKU
optional
该商品的库存单位(SKU)_. string
ItemCondition
required
物品的状况. ConditionType
status
required
该操作的状态. string
标识符
required
识别项目的元数据. ItemIdentifier
摘要
必填
关于项目的价格信息. 摘要
Offers
required
A list of offer details.该列表的长度与Summary中的TotalOfferCount或20,以较少者为准. OfferDetailList

<a name="httprequestheaders">

# HttpRequestHeaders

一个额外的HTTP头的映射,用于发送/接收单个批次的请求.

类型 : < string, string >映射

<a name="httpresponseheaders">

# HttpResponseHeaders

一个额外的HTTP头的映射,用于发送/接收单个批次的请求.

类型 : < string, string >映射

<a name="getoffershttpstatusline">

# GetOffersHttpStatusLine

与响应相关的HTTP状态行.更多信息,请参考RFC 2616 (opens new window).

Name Description Schema
statusCode
optional
HTTP响应状态代码.
最小值 : 100
最大值 : 599
integer
reasonPhrase
optional
The HTTP response Reason-Phase. string

<a name="httpspmethod">

# HttpMethod

与作为批处理请求的一部分被调用的各个API相关的HTTP方法.

类型 : 枚举

Value Description
GET GET
PUT PUT
PATCH PATCH
DELETE DELETE
POST POST

<a name="batchrequest">

# BatchRequest

针对个别API的批量请求的共同属性.

Name Description Schema
uri
required
对应于打算请求的API的完整URI,包括路径参数的替换. string
method
required
与作为批量请求的一部分被调用的各个API相关的HTTP方法. HttpMethod
headers
optional
A映射额外的HTTP头,为单个批处理请求发送/接收. HttpRequestHeaders

<a name="price">

# Price

Name Description Schema
status
required
操作的状态. string
SellerSKU
可选的
物品的卖方库存单位(SKU). string
ASIN
optional
该商品的亚马逊标准识别码(ASIN). string
Product
optional
An item. Product

<a name="product">

# Product

一个项目.

Name Description Schema
标识符
必须的
指定用于唯一识别物品的标识符. 标识符类型
AttributeSets
optional
A list of product attributes if they are applicable to the product that is returned. AttributeSetList
关系
可选
A 列表,包含产品的变化信息,如果适用的话. RelationshipList
CompetitivePricing
optional
Competitive pricing information for the item. CompetitivePricingType
SalesRankings
optional
A list of sales rank information for the item, by category. SalesRankList
Offers
optional
A list of offers. OffersList

<a name="标识符类型">

# IdentifierType

指定用于唯一标识一个项目的标识符.

Name Description Schema
MarketplaceASIN
required
表示该物品由MarketPlaceId和ASIN. ASINIdentifier
SKUIdentifier
optional
表示该物品由MarketPlaceId、SellerId和SellerSKU. SellerSKUIdentifier

<a name="asinidentifier">

# ASINIdentifier

Name Description Schema
MarketplaceId
required
A marketplace identifier. string
ASIN
required
亚马逊标准识别码(ASIN)的物品. string

<a name="sellerskuidentifier">

# SellerSKUIdentifier

Name Description Schema
MarketplaceId
required
A marketplace identifier. string
*SellerId
required
为该操作提交的卖方标识符. string
SellerSKU
required
卖家库存单位(SKU)的物品. string

<a name="attributesetlist">

# AttributeSetList

一个产品属性的列表,如果它们适用于被返回的产品.

类型 <对象>数组

<a name="关系列表">

# RelationshipList

一个包含产品变异信息的列表,如果适用的话.

类型 <对象>数组

<a name="competitivepricingtype">

# CompetitivePricingType

项目的竞争性定价信息.

Name Description Schema
竞争性价格
要求
竞争性价格信息清单. 竞争性价格清单
NumberOfOfferListings
required
提交的物品的有效报价列表的数量.列表计数按条件返回,每个列表条件值返回一个. NumberOfOfferListingsList
TradeInValue
optional
该物品在贸易-程序中的贸易-值. MoneyType

<a name="competitivepricelist">

# CompetitivePriceList

竞争性价格信息的列表.

类型 < CompetitivePriceType > 数组

<a name="competitivepricetype">

# CompetitivePriceType

Name Description Schema
CompetitivePriceId
required
返回的每个价格的定价模式.

可能的值:

  • 1 -新买箱价格.

  • 2 -二手买箱价格.
  • string
    *价格
    所需
    定价信息为一个给定的CompetitivePriceId值. PriceType
    condition
    optional
    表示定价信息被返回的物品的状况.可能的值是新的、二手的、收藏的、翻新的或俱乐部的. string
    子条件
    可选
    表示返回定价信息的物品的子条件.可能的值是:新的、新的、很好的、很好的新的, 新鲜的, 非常好的, 好的, 可接受的, 差的, 俱乐部, OEM, 保修, 翻新保修, 翻新, 开箱, 或其他. string
    offerType
    optional
    表示该offer有效的客户类型.

    当offer类型为B2C的数量折扣时,卖家赢得Buy Box是因为其他人没有该数量的库存,而不是因为他们对ASIN有数量折扣.
    OfferCustomerType
    quantityTier
    optional
    表示这个价格在什么数量上变得活跃. integer (int32)
    quantityDiscountType
    optional
    表示此价格适用的数量折扣类型. QuantityDiscountType
    sellerId
    optional
    报价的卖方标识符. string
    belongsToRequester
    optional
    表示定价信息是否属于请求者的报价列表.请求者是与请求时提交的SellerId相关的卖家.可能的值是:true 和 false. boolean

    <a name="numberofofferlistingslist">

    # NumberOfOfferListingsList

    被提交的物品的有效报价列表数量.列表计数按条件返回,每个列表条件值返回一个.

    类型 : < OfferListingCountType > 数组

    <a name="offerlistingcounttype">

    # OfferListingCountType

    具有指定条件的报价列表的数量.

    Name Description Schema
    Count
    required
    offer listings的数量. integer (int32)
    condition
    required
    物品的状况. string

    <a name="moneytype">

    # MoneyType

    Name Description Schema
    CurrencyCode
    optional
    ISO 4217格式的货币代码. string
    金额
    可选择
    货币价值. 数字

    <a name="salesranklist">

    # SalesRankList

    该物品的销售排名信息的列表,按类别划分.

    类型< SalesRankType >数组

    <a name="salesranktype">

    # SalesRankType

    Name Description Schema
    ProductCategoryId
    required
    确定销售排名所来自的物品类别. string
    Rank
    required
    物品在该物品类别中的销售排名. integer (int32)

    <a name="pricetype">

    # PriceType

    Name Description Schema
    LandedPrice
    optional
    通过添加ListingPrice+Shipping- Points.计算出的数值,注意如果不返回落地价,则Listing Price代表最低落地价的产品. MoneyType
    ListingPrice
    required
    物品的上市价格,包括任何适用的促销活动. MoneyType
    运费
    可选
    产品的运费.注意,运费并不总是可用. MoneyType
    Points
    optional
    购买商品时提供的亚马逊积分的数量,以及它们的货币价值. Points

    <a name="offerslist">

    # OffersList

    一张报价清单.

    类型< OfferType > 数组

    <a name="offertype">

    # OfferType

    表示是否要求卖方的B2C或B2B报价的价格信息.默认为B2C.

    类型 : 枚举

    Value Description
    B2C B2C
    B2B B2B

    <a name="offercustomertype">

    # OfferCustomerType

    类型 : 枚举

    Value Description
    B2C B2C
    B2B B2B

    <a name="quantitydiscountpricetype">

    # QuantityDiscountPriceType

    包含定价信息,包括大量购买时的特殊定价.

    Name Description Schema
    quantityTier
    required
    表示这个价格在什么数量上会变得活跃. integer (int32)
    quantityDiscountType
    required
    表示此价格适用的数量折扣类型. QuantityDiscountType
    listingPrice
    required
    这个数量层的价格. MoneyType

    <a name="quantitydiscounttype">

    # QuantityDiscountType

    类型 : 枚举

    Value Description
    QUANTITY_DISCOUNT Quantity Discount

    <a name="point">

    # Points

    Name Description Schema
    PointsNumber
    optional
    The number of points. integer (int32)
    PointsMonetaryValue
    optional
    积分的货币价值. MoneyType

    <a name="条件类型">

    # ConditionType

    表示物品的状况. 可能的值新的, 二手的, 收藏的, 翻新的, 俱乐部的.

    类型 : 枚举

    Value Description
    New New
    Used Used
    Collectible Collectible
    Refurbished Refurbished
    Club Club

    <a name="itemidentifier">

    # ItemIdentifier

    识别一个物品的信息.

    Name Description Schema
    MarketplaceId
    required
    A marketplace identifier. 指定返回价格的市场. string
    ASIN
    可选的
    亚马逊标准识别码(ASIN)物品的标准识别码. string
    SellerSKU
    optional
    该商品的卖家库存单位(SKU). string
    ItemCondition
    required
    物品的状况. ConditionType

    <a name="summary">

    # Summary

    包含产品的价格信息,包括LowestPrices和BuyBoxPrices,ListPrice,SuggestedLowerPricePlusShipping,以及NumberOfOffers和NumberOfBuyBoxEligibleOffers.

    Name Description Schema
    TotalOfferCount
    required
    NumberOfOffers. integer (int32)
    NumberOfOffers
    optional
    一个列表,包含了该项目在给定条件和履行渠道下的报价总数. NumberOfOffers
    LowestPrices
    optional
    A list of the lowest prices for the item. LowestPrices
    BuyBoxPrices
    optional
    A项目价格列表. BuyBoxPrices
    ListPrice
    optional
    制造商建议的物品清单价格. MoneyType
    CompetitivePriceThreshold
    optional
    这个价格是基于其他零售商的竞争价格(不包括其他亚马逊卖家).如果卖家的价格+运费(减去亚马逊积分)大于这个竞争价格,该商品可能不符合购买框的要求. MoneyType
    SuggestedLowerPricePlusShipping
    optional
    该商品的建议低价,包括运费和亚马逊积分.建议低价是基于一系列因素,包括历史销售价格、最近的Buy Box-合格价格,以及客户对你产品的输入. MoneyType
    SalesRankings
    optional
    A 列表,包含了项目在给定产品类别中的销售排名. SalesRankList
    BuyBoxEligibleOffers
    optional
    A 列表,其中包含在给定条件和履行渠道下有资格获得Buy Box的报价总数. BuyBoxEligibleOffers
    OffersAvailableTime
    optional
    当状态为ActiveButTooSoonForProcessing时,这就是优惠可供处理的时间. string (date-time)

    <a name="buyboxeligibleoffers">

    # BuyBoxEligibleOffers

    类型 < OfferCountType > 数组

    <a name="buyboxprices">

    # BuyBoxPrices

    类型 < BuyBoxPriceType > 数组

    <a name="最低价格">

    # LowestPrices

    类型 < LowestPriceType > 数组

    <a name="numberofoffers">

    # NumberOfOffers

    类型 < OfferCountType > 数组

    <a name="offercounttype">

    # OfferCountType

    指定条件和履行渠道的报价总数.

    Name Description Schema
    condition
    optional
    表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的. string
    fulfillmentChannel
    optional
    表示该商品是由亚马逊履行还是由卖方履行. FulfillmentChannelType
    OfferCount
    optional
    一个履行渠道中满足特定条件的报价数量. integer (int32)

    <a name="fulfillmentchanneltype">

    # FulfillmentChannelType

    表示该物品是由亚马逊履行还是由卖家履行(merchant).

    类型 : 枚举

    Value Description
    亚马逊 由亚马逊提供服务.
    商家 由卖家履行.

    <a name=" lowestpricetype">

    # LowestPriceType

    Name Description Schema
    condition
    required
    表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部的. string
    fulfillmentChannel
    required
    表示该商品是由亚马逊履行还是由卖家履行. string
    offerType
    optional
    表示该优惠适用的客户类型. OfferCustomerType
    quantityTier
    optional
    表示这个价格在什么数量上变得有效. integer (int32)
    quantityDiscountType
    optional
    表示此价格适用的数量折扣类型. QuantityDiscountType
    LandedPrice
    required
    通过添加ListingPrice + Shipping - Points. MoneyType
    ListingPrice
    required
    物品的价格. MoneyType
    Shipping
    required
    The shipping cost. MoneyType
    Points
    optional
    购买商品时提供的亚马逊积分数量. Points

    <a name="buyboxpricetype">

    # BuyBoxPriceType

    Name Description Schema
    condition
    required
    表示物品的状况.例如新的,二手的,收藏的,翻新的,或俱乐部. string
    offerType
    optional
    表示该offer有效的客户类型.

    当offer类型为B2C的数量折扣时,卖家赢得Buy Box是因为其他人没有该数量的库存,而不是因为他们对ASIN有数量折扣.
    OfferCustomerType
    quantityTier
    optional
    表示这个价格在什么数量上变得活跃. integer (int32)
    quantityDiscountType
    optional
    表示此价格适用的数量折扣类型. QuantityDiscountType
    LandedPrice
    required
    通过添加ListingPrice + Shipping - Points. MoneyType
    ListingPrice
    required
    物品的价格. MoneyType
    Shipping
    required
    The shipping cost. MoneyType
    Points
    optional
    购买商品时提供的亚马逊积分数量. Points
    sellerId
    optional
    offer的卖家标识. string

    <a name="offerdetaillist">

    # OfferDetailList

    类型 < OfferDetail >阵列

    最大项目 : 20

    <a name="offerdetail">

    # OfferDetail

    Name Description Schema
    MyOffer
    optional
    为真时,这是卖方的报价. boolean
    offerType
    optional
    表示该offer有效的客户类型. OfferCustomerType
    子条件
    要求
    物品的子条件.子条件值新的、全新的、非常好的、好的、可接受的、差的、俱乐部的、OEM的、保修的、翻新保修的、翻新的、开箱的、或其他. string
    SellerId
    optional
    该报价的卖家识别码. string
    ConditionNotes
    optional
    关于物品状况的信息. string
    SellerFeedbackRating
    optional
    关于卖家的反馈信息,包括正面反馈的百分比,以及收到的评价总数. SellerFeedbackType
    ShippingTime
    required
    一旦下了订单,该商品可能被运走的最长时间. DetailedShippingTimeType
    ListingPrice
    required
    物品的价格. MoneyType
    quantityDiscountPrices
    optional
    - < QuantityDiscountPriceType > array
    Points
    optional
    购买商品时提供的亚马逊积分数量. Points
    Shipping
    required
    The shipping cost. MoneyType
    ShipsFrom
    optional
    物品被运出的州和国家. ShipsFromType
    IsFulfilledByAmazon
    required
    为真时,该商品由亚马逊履行. boolean
    PrimeInformation
    optional
    Amazon Prime information. PrimeInformationType
    IsBuyBoxWinner
    optional
    为真时,该产品目前在Buy Box中.每个ASIN在任何时候最多可以有两个Buy Box赢家,一个有资格获得Prime,一个没有资格获得Prime. boolean
    IsFeaturedMerchant
    optional
    为真时,该商品的卖家有资格赢得Buy Box. boolean

    <a name="priminformationtype">

    # PrimeInformationType

    亚马逊Prime信息.

    Name Description Schema
    IsPrime
    required
    表示该优惠是否是亚马逊的Prime优惠. boolean
    *IsNationalPrime
    required
    表示该产品在其上市的整个市场上是否为亚马逊Prime产品. boolean

    <a name="sellerfeedbacktype">

    # SellerFeedbackType

    关于卖家的反馈信息,包括正面反馈的百分比,以及收到的评价总数.

    Name Description Schema
    SellerPositiveFeedbackRating
    optional
    过去365天内卖家的正面反馈百分比. number (double)
    FeedbackCount
    required
    收到的关于卖家的评价数量. integer (int64)

    <a name="errorlist">

    # ErrorList

    当请求不成功时返回的错误响应列表.

    类型 < Error > 数组

    <a name="detailshippingtimetype">

    # DetailedShippingTimeType

    订单下达后,商品可能被运走的时间范围.

    Name Description Schema
    minimumHours
    optional
    下单后物品可能被运走的最短时间,以小时为单位. integer (int64)
    maximumHours
    optional
    订单下达后,商品可能被运送的最长时间(小时). integer (int64)
    availableDate
    optional
    商品可以发货的日期.只显示给目前不能发货的商品. string
    availabilityType
    optional
    表示物品是现在可以发货,还是在未来一个已知或未知的日期可以发货.如果已知,availableDate属性表示物品将可以发货的日期.可能的值NOW, FUTURE_WITHOUT_DATE, FUTURE_WITH_DATE. enum (AvailabilityType)

    <a name="shipsfromtype">

    # ShipsFromType

    该物品被运出的州和国家.

    Name Description Schema
    *State
    optional
    物品发运的国家. string
    Country
    optional
    物品运送的国家. string

    <a name="marketplaceid">

    # MarketplaceId

    一个市场的标识符.指定返回价格的市场.

    类型:字符串

    <a name="itemcondition">

    # ItemCondition

    类型 : 枚举

    <a id="itemcondition-subgroup-1">用于操作(s)getPricing, getListingOffers 根据物品条件过滤报价列表.可能的值新的, 二手的, 收藏的, 翻新的, 俱乐部.

    Value Description
    New New
    Used Used
    Collectible Collectible
    Refurbished Refurbished
    Club Club

    <a id="itemcondition-subgroup-2">供操作(s)使用getItemOffers 根据物品条件过滤要考虑的报价清单.可能的值新的, 二手的, 收藏的, 翻新的, 俱乐部.

    Value Description
    New New
    Used Used
    Collectible Collectible
    Refurbished Refurbished
    Club Club

    <a name="customertype">

    # CustomerType

    类型 : 枚举

    <a id="customertype-subgroup-1">用于操作(s)getCompetitivePricing 表示是否从消费者或企业买家的角度请求定价信息.默认为消费者.

    Value Description
    Consumer Consumer
    Business Business

    <a id="customertype-subgroup-2">供操作(s)使用getListingOffers, getItemOffers 表示是否请求消费者或企业提供.默认为消费者.

    Value Description
    Consumer Consumer
    Business Business

    <a name="error">

    # Error

    当请求不成功时返回的错误响应.

    Name Description Schema
    code
    required
    一个错误代码,用于识别所发生的错误类型. string
    message
    required
    一个以人类可读的形式描述错误情况的信息. string
    details
    optional
    可以帮助呼叫者理解或解决这个问题的额外信息. string

    <a name="availabilitytype">

    # AvailabilityType

    表示该物品是现在可以发货,还是在未来某个已知或未知的日期可以发货. 如果已知,availableDate属性表示该物品可以发货的日期. 可能的值现在, 未来_无日期, 未来_有日期.

    类型 : 枚举

    Value Description
    NOW 该物品现在可以发货.
    FUTURE_WITHOUT_DATE 该物品将在未来的某个未知日期发货.
    FUTURE_WITH_DATE 该商品将在未来的一个已知日期发货.

    <a name="itemtype">

    # ItemType

    类型 : 枚举

    <a id="itemtype-subgroup-1">用于操作(s)getPricing 表示是否使用ASIN值或卖方SKU值来识别物品. 如果你指定Asin,响应中的信息将取决于你在Asins参数中提供的Asin列表. 如果你指定Sku,响应中的信息将取决于你在Skus参数中提供的Skus列表.

    Value Description
    Asin 亚马逊标准识别号(ASIN).
    Sku 卖家的SKU.

    <a id="itemtype-subgroup-2">用于操作(s)getCompetitivePricing 表示是否使用ASIN值或卖方SKU值来识别商品. 如果你指定Asin,响应中的信息将取决于你在Asins参数中提供的Asin列表. 如果你指定Sku,响应中的信息将取决于你在Skus参数中提供的Skus列表. 可能的值Asin, Sku.

    Value Description
    Asin 亚马逊标准识别号(ASIN).
    Sku 卖家的SKU.
    Last Updated: 2022/10/17 下午9:17:02