Product Pricing API v0 reference

Retrieve product pricing and offer information for Amazon Marketplace products.

Overview

The Selling Partner API for Pricing helps you programmatically retrieve product pricing and offer information for Amazon Marketplace products.

Version information

Version : v0

Contact information

Contact : Selling Partner API Developer Support
Contact URL : https://sellercentral.amazon.com/gp/mws/contactus.html

License information

License : Apache License 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0

URI scheme

Host : sellingpartnerapi-na.amazon.com
Schemes : HTTPS

Consumes

  • application/json

Produces

  • application/json

Operations

getPricing
getCompetitivePricing
getListingOffers
getItemOffers
getItemOffersBatch
getListingOffersBatch

Paths

GET /products/pricing/v0/price

Operation: getPricing

Description

Returns pricing information for a seller's offer listings based on seller SKU or ASIN.

Usage Plan:

Rate (requests per second)Burst
1020

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
QueryMarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.string
QueryAsins
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
QuerySkus
optional
A list of up to twenty seller SKU values used to identify items in the given marketplace.
Max count : 20
< string > array
QueryItemType
required
Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.enum (ItemType)
QueryItemCondition
optional
Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.enum (ItemCondition)
QueryOfferType
optional
Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.enum (OfferType)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse

GET /products/pricing/v0/competitivePrice

Operation: getCompetitivePricing

Description

Returns competitive pricing information for a seller's offer listings based on seller SKU or ASIN.

Usage Plan:

Rate (requests per second)Burst
1020

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
QueryMarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.string
QueryAsins
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
QuerySkus
optional
A list of up to twenty seller SKU values used to identify items in the given marketplace.
Max count : 20
< string > array
QueryItemType
required
Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.enum (ItemType)
QueryCustomerType
optional
Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.enum (CustomerType)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetPricingResponse

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

Operation: getListingOffers

Description

Returns the lowest priced offers for a single SKU listing.

Usage Plan:

Rate (requests per second)Burst
510

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
QueryMarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.string
QueryItemCondition
required
Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.enum (ItemCondition)
PathSellerSKU
required
Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.string
QueryCustomerType
optional
Indicates whether to request Consumer or Business offers. Default is Consumer.enum (CustomerType)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse

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

Operation: getItemOffers

Description

Returns the lowest priced offers for a single item based on ASIN.

Usage Plan:

Rate (requests per second)Burst
510

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
QueryMarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.string
QueryItemCondition
required
Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.enum (ItemCondition)
PathAsin
required
The Amazon Standard Identification Number (ASIN) of the item.string
QueryCustomerType
optional
Indicates whether to request Consumer or Business offers. Default is Consumer.enum (CustomerType)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
GetOffersResponse

POST /batches/products/pricing/v0/itemOffers

Operation: getItemOffersBatch

Description

Returns the lowest priced offers for a batch of items based on ASIN.

Usage Plan:

Rate (requests per second)Burst
.51

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
BodygetItemOffersBatchRequestBody
required
The request associated with the getItemOffersBatch API call.GetItemOffersBatchRequest

Responses

HTTP CodeDescriptionSchema
200Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetItemOffersBatchResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
Errors
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors

POST /batches/products/pricing/v0/listingOffers

Operation: getListingOffersBatch

Description

Returns the lowest priced offers for a batch of listings by SKU.

Usage Plan:

Rate (requests per second)Burst
.51

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The table above indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may see higher rate and burst values than those shown here. For more information, see Usage Plans and Rate Limits in the Selling Partner API.

Parameters

TypeNameDescriptionSchema
BodygetListingOffersBatchRequestBody
required
The request associated with the getListingOffersBatch API call.GetListingOffersBatchRequest

Responses

HTTP CodeDescriptionSchema
200Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
GetListingOffersBatchResponse
400Request has missing or invalid parameters and cannot be parsed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
401The request's Authorization header is not formatted correctly or does not contain a valid token.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
403Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
Headers :
x-amzn-RequestId (string) : Unique request reference ID.
Errors
404The specified resource does not exist.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
429The frequency of requests was greater than allowed.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
500An unexpected condition occurred that prevented the server from fulfilling the request.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors
503Temporary overloading or maintenance of the server.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
Note: For this status code, the rate limit header is deprecated and no longer returned.
x-amzn-RequestId (string) : Unique request reference ID.
Errors

Definitions

GetItemOffersBatchRequest

The request associated with the getItemOffersBatch API call.

NameDescriptionSchema
requests
optional
A list of getItemOffers batched requests to run.ItemOffersRequestList

GetListingOffersBatchRequest

The request associated with the getListingOffersBatch API call.

NameDescriptionSchema
requests
optional
A list of getItemOffers batched requests to run.ListingOffersRequestList

ListingOffersRequestList

A list of getItemOffers batched requests to run.

Type : < ListingOffersRequest > array

Min items : 1
Max items : 20

ItemOffersRequestList

A list of getItemOffers batched requests to run.

Type : < ItemOffersRequest > array

Min items : 1
Max items : 20

BatchOffersRequestParams

NameDescriptionSchema
MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.MarketplaceId
ItemCondition
required
-ItemCondition
CustomerType
optional
-CustomerType

ItemOffersRequest

Polymorphism : Composition

NameDescriptionSchema
uri
required
The full URI corresponding to the API intended for request, including path parameter substitutions.string
method
required
The HTTP method associated with the individual APIs being called as part of the batch request.HttpMethod
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpRequestHeaders
MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.MarketplaceId
ItemCondition
required
-ItemCondition
CustomerType
optional
-CustomerType

ListingOffersRequest

Polymorphism : Composition

NameDescriptionSchema
uri
required
The full URI corresponding to the API intended for request, including path parameter substitutions.string
method
required
The HTTP method associated with the individual APIs being called as part of the batch request.HttpMethod
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpRequestHeaders
MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.MarketplaceId
ItemCondition
required
-ItemCondition
CustomerType
optional
-CustomerType

GetItemOffersBatchResponse

The response associated with the getItemOffersBatch API call.

NameDescriptionSchema
responses
optional
A list of getItemOffers batched responses.ItemOffersResponseList

GetListingOffersBatchResponse

The response associated with the getListingOffersBatch API call.

NameDescriptionSchema
responses
optional
A list of getListingOffers batched responses.ListingOffersResponseList

ItemOffersResponseList

A list of getItemOffers batched responses.

Type : < ItemOffersResponse > array

Min items : 1
Max items : 20

ListingOffersResponseList

A list of getListingOffers batched responses.

Type : < ListingOffersResponse > array

Min items : 1
Max items : 20

BatchOffersResponse

NameDescriptionSchema
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpResponseHeaders
status
optional
The HTTP status line associated with the response. For more information, consult RFC 2616.GetOffersHttpStatusLine
body
required
The response schema for the getListingOffers and getItemOffers operations.GetOffersResponse

ItemOffersRequestParams

Polymorphism : Composition

NameDescriptionSchema
MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.MarketplaceId
ItemCondition
required
-ItemCondition
CustomerType
optional
-CustomerType
Asin
optional
The Amazon Standard Identification Number (ASIN) of the item. This is the same Asin passed as a request parameter.string

ItemOffersResponse

Polymorphism : Composition

NameDescriptionSchema
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpResponseHeaders
status
optional
The HTTP status line associated with the response. For more information, consult RFC 2616.GetOffersHttpStatusLine
body
required
The response schema for the getListingOffers and getItemOffers operations.GetOffersResponse
request
required
-ItemOffersRequestParams

ListingOffersRequestParams

Polymorphism : Composition

NameDescriptionSchema
MarketplaceId
required
A marketplace identifier. Specifies the marketplace for which prices are returned.MarketplaceId
ItemCondition
required
-ItemCondition
CustomerType
optional
-CustomerType
SellerSKU
required
The seller stock keeping unit (SKU) of the item. This is the same SKU passed as a path parameter.string

ListingOffersResponse

Polymorphism : Composition

NameDescriptionSchema
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpResponseHeaders
status
optional
The HTTP status line associated with the response. For more information, consult RFC 2616.GetOffersHttpStatusLine
body
required
The response schema for the getListingOffers and getItemOffers operations.GetOffersResponse
request
optional
-ListingOffersRequestParams

Errors

A list of error responses returned when a request is unsuccessful.

NameDescriptionSchema
errors
required
One or more unexpected errors occurred during the operation.ErrorList

GetPricingResponse

The response schema for the getPricing and getCompetitivePricing operations.

NameDescriptionSchema
payload
optional
The payload for the getPricing and getCompetitivePricing operations.PriceList
errors
optional
One or more unexpected errors occurred during the operation.ErrorList

GetOffersResponse

The response schema for the getListingOffers and getItemOffers operations.

NameDescriptionSchema
payload
optional
The payload for the getListingOffers and getItemOffers operations.GetOffersResult
errors
optional
One or more unexpected errors occurred during the operation.ErrorList

PriceList

Type : < Price > array

Max items : 20

GetOffersResult

NameDescriptionSchema
MarketplaceID
required
A marketplace identifier.string
ASIN
optional
The Amazon Standard Identification Number (ASIN) of the item.string
SKU
optional
The stock keeping unit (SKU) of the item.string
ItemCondition
required
The condition of the item.ConditionType
status
required
The status of the operation.string
Identifier
required
Metadata that identifies the item.ItemIdentifier
Summary
required
Pricing information about the item.Summary
Offers
required
A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less.OfferDetailList

HttpRequestHeaders

A mapping of additional HTTP headers to send/receive for the individual batch request.

Type : < string, string > map

HttpResponseHeaders

A mapping of additional HTTP headers to send/receive for the individual batch request.

Type : < string, string > map

GetOffersHttpStatusLine

The HTTP status line associated with the response. For more information, consult RFC 2616.

NameDescriptionSchema
statusCode
optional
The HTTP response Status Code.
Minimum value : 100
Maximum value : 599
integer
reasonPhrase
optional
The HTTP response Reason-Phase.string

HttpMethod

The HTTP method associated with the individual APIs being called as part of the batch request.

Type : enum

ValueDescription
GETGET
PUTPUT
PATCHPATCH
DELETEDELETE
POSTPOST

BatchRequest

Common properties of batch requests against individual APIs.

NameDescriptionSchema
uri
required
The full URI corresponding to the API intended for request, including path parameter substitutions.string
method
required
The HTTP method associated with the individual APIs being called as part of the batch request.HttpMethod
headers
optional
A mapping of additional HTTP headers to send/receive for the individual batch request.HttpRequestHeaders

Price

NameDescriptionSchema
status
required
The status of the operation.string
SellerSKU
optional
The seller stock keeping unit (SKU) of the item.string
ASIN
optional
The Amazon Standard Identification Number (ASIN) of the item.string
Product
optional
An item.Product

Product

An item.

NameDescriptionSchema
Identifiers
required
Specifies the identifiers used to uniquely identify an item.IdentifierType
AttributeSets
optional
A list of product attributes if they are applicable to the product that is returned.AttributeSetList
Relationships
optional
A list that contains product variation information, if applicable.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

IdentifierType

Specifies the identifiers used to uniquely identify an item.

NameDescriptionSchema
MarketplaceASIN
required
Indicates the item is identified by MarketPlaceId and ASIN.ASINIdentifier
SKUIdentifier
optional
Indicates the item is identified by MarketPlaceId, SellerId, and SellerSKU.SellerSKUIdentifier

ASINIdentifier

NameDescriptionSchema
MarketplaceId
required
A marketplace identifier.string
ASIN
required
The Amazon Standard Identification Number (ASIN) of the item.string

SellerSKUIdentifier

NameDescriptionSchema
MarketplaceId
required
A marketplace identifier.string
SellerId
required
The seller identifier submitted for the operation.string
SellerSKU
required
The seller stock keeping unit (SKU) of the item.string

AttributeSetList

A list of product attributes if they are applicable to the product that is returned.

Type : < object > array

RelationshipList

A list that contains product variation information, if applicable.

Type : < object > array

CompetitivePricingType

Competitive pricing information for the item.

NameDescriptionSchema
CompetitivePrices
required
A list of competitive pricing information.CompetitivePriceList
NumberOfOfferListings
required
The number of active offer listings for the item that was submitted. The listing count is returned by condition, one for each listing condition value that is returned.NumberOfOfferListingsList
TradeInValue
optional
The trade-in value of the item in the trade-in program.MoneyType

CompetitivePriceList

A list of competitive pricing information.

Type : < CompetitivePriceType > array

CompetitivePriceType

NameDescriptionSchema
CompetitivePriceId
required
The pricing model for each price that is returned.

Possible values:

  • 1 - New Buy Box Price.

  • 2 - Used Buy Box Price.
  • string
    Price
    required
    Pricing information for a given CompetitivePriceId value.PriceType
    condition
    optional
    Indicates the condition of the item whose pricing information is returned. Possible values are: New, Used, Collectible, Refurbished, or Club.string
    subcondition
    optional
    Indicates the subcondition of the item whose pricing information is returned. Possible values are: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.string
    offerType
    optional
    Indicates the type of customer that the offer is valid for.

    When the offer type is B2C in a quantity discount, the seller is winning the Buy Box because others do not have inventory at that quantity, not because they have a quantity discount on the ASIN.
    OfferCustomerType
    quantityTier
    optional
    Indicates at what quantity this price becomes active.integer (int32)
    quantityDiscountType
    optional
    Indicates the type of quantity discount this price applies to.QuantityDiscountType
    sellerId
    optional
    The seller identifier for the offer.string
    belongsToRequester
    optional
    Indicates whether or not the pricing information is for an offer listing that belongs to the requester. The requester is the seller associated with the SellerId that was submitted with the request. Possible values are: true and false.boolean

    NumberOfOfferListingsList

    The number of active offer listings for the item that was submitted. The listing count is returned by condition, one for each listing condition value that is returned.

    Type : < OfferListingCountType > array

    OfferListingCountType

    The number of offer listings with the specified condition.

    NameDescriptionSchema
    Count
    required
    The number of offer listings.integer (int32)
    condition
    required
    The condition of the item.string

    MoneyType

    NameDescriptionSchema
    CurrencyCode
    optional
    The currency code in ISO 4217 format.string
    Amount
    optional
    The monetary value.number

    SalesRankList

    A list of sales rank information for the item, by category.

    Type : < SalesRankType > array

    SalesRankType

    NameDescriptionSchema
    ProductCategoryId
    required
    Identifies the item category from which the sales rank is taken.string
    Rank
    required
    The sales rank of the item within the item category.integer (int32)

    PriceType

    NameDescriptionSchema
    LandedPrice
    optional
    The value calculated by adding ListingPrice + Shipping - Points. Note that if the landed price is not returned, the listing price represents the product with the lowest landed price.MoneyType
    ListingPrice
    required
    The listing price of the item including any promotions that apply.MoneyType
    Shipping
    optional
    The shipping cost of the product. Note that the shipping cost is not always available.MoneyType
    Points
    optional
    The number of Amazon Points offered with the purchase of an item, and their monetary value.Points

    OffersList

    A list of offers.

    Type : < OfferType > array

    OfferType

    Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.

    Type : enum

    ValueDescription
    B2CB2C
    B2BB2B

    OfferCustomerType

    Type : enum

    ValueDescription
    B2CB2C
    B2BB2B

    QuantityDiscountPriceType

    Contains pricing information that includes special pricing when buying in bulk.

    NameDescriptionSchema
    quantityTier
    required
    Indicates at what quantity this price becomes active.integer (int32)
    quantityDiscountType
    required
    Indicates the type of quantity discount this price applies to.QuantityDiscountType
    listingPrice
    required
    The price at this quantity tier.MoneyType

    QuantityDiscountType

    Type : enum

    ValueDescription
    QUANTITY_DISCOUNTQuantity Discount

    Points

    NameDescriptionSchema
    PointsNumber
    optional
    The number of points.integer (int32)
    PointsMonetaryValue
    optional
    The monetary value of the points.MoneyType

    ConditionType

    Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club.

    Type : enum

    ValueDescription
    NewNew
    UsedUsed
    CollectibleCollectible
    RefurbishedRefurbished
    ClubClub

    ItemIdentifier

    Information that identifies an item.

    NameDescriptionSchema
    MarketplaceId
    required
    A marketplace identifier. Specifies the marketplace from which prices are returned.string
    ASIN
    optional
    The Amazon Standard Identification Number (ASIN) of the item.string
    SellerSKU
    optional
    The seller stock keeping unit (SKU) of the item.string
    ItemCondition
    required
    The condition of the item.ConditionType

    Summary

    Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers.

    NameDescriptionSchema
    TotalOfferCount
    required
    The number of unique offers contained in NumberOfOffers.integer (int32)
    NumberOfOffers
    optional
    A list that contains the total number of offers for the item for the given conditions and fulfillment channels.NumberOfOffers
    LowestPrices
    optional
    A list of the lowest prices for the item.LowestPrices
    BuyBoxPrices
    optional
    A list of item prices.BuyBoxPrices
    ListPrice
    optional
    The list price of the item as suggested by the manufacturer.MoneyType
    CompetitivePriceThreshold
    optional
    This price is based on competitive prices from other retailers (excluding other Amazon sellers). The offer may be ineligible for the Buy Box if the seller's price + shipping (minus Amazon Points) is greater than this competitive price.MoneyType
    SuggestedLowerPricePlusShipping
    optional
    The suggested lower price of the item, including shipping and Amazon Points. The suggested lower price is based on a range of factors, including historical selling prices, recent Buy Box-eligible prices, and input from customers for your products.MoneyType
    SalesRankings
    optional
    A list that contains the sales rank of the item in the given product categories.SalesRankList
    BuyBoxEligibleOffers
    optional
    A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels.BuyBoxEligibleOffers
    OffersAvailableTime
    optional
    When the status is ActiveButTooSoonForProcessing, this is the time when the offers will be available for processing.string (date-time)

    BuyBoxEligibleOffers

    Type : < OfferCountType > array

    BuyBoxPrices

    Type : < BuyBoxPriceType > array

    LowestPrices

    Type : < LowestPriceType > array

    NumberOfOffers

    Type : < OfferCountType > array

    OfferCountType

    The total number of offers for the specified condition and fulfillment channel.

    NameDescriptionSchema
    condition
    optional
    Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.string
    fulfillmentChannel
    optional
    Indicates whether the item is fulfilled by Amazon or by the seller.FulfillmentChannelType
    OfferCount
    optional
    The number of offers in a fulfillment channel that meet a specific condition.integer (int32)

    FulfillmentChannelType

    Indicates whether the item is fulfilled by Amazon or by the seller (merchant).

    Type : enum

    ValueDescription
    AmazonFulfilled by Amazon.
    MerchantFulfilled by the seller.

    LowestPriceType

    NameDescriptionSchema
    condition
    required
    Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.string
    fulfillmentChannel
    required
    Indicates whether the item is fulfilled by Amazon or by the seller.string
    offerType
    optional
    Indicates the type of customer that the offer is valid for.OfferCustomerType
    quantityTier
    optional
    Indicates at what quantity this price becomes active.integer (int32)
    quantityDiscountType
    optional
    Indicates the type of quantity discount this price applies to.QuantityDiscountType
    LandedPrice
    required
    The value calculated by adding ListingPrice + Shipping - Points.MoneyType
    ListingPrice
    required
    The price of the item.MoneyType
    Shipping
    required
    The shipping cost.MoneyType
    Points
    optional
    The number of Amazon Points offered with the purchase of an item.Points

    BuyBoxPriceType

    NameDescriptionSchema
    condition
    required
    Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.string
    offerType
    optional
    Indicates the type of customer that the offer is valid for.

    When the offer type is B2C in a quantity discount, the seller is winning the Buy Box because others do not have inventory at that quantity, not because they have a quantity discount on the ASIN.
    OfferCustomerType
    quantityTier
    optional
    Indicates at what quantity this price becomes active.integer (int32)
    quantityDiscountType
    optional
    Indicates the type of quantity discount this price applies to.QuantityDiscountType
    LandedPrice
    required
    The value calculated by adding ListingPrice + Shipping - Points.MoneyType
    ListingPrice
    required
    The price of the item.MoneyType
    Shipping
    required
    The shipping cost.MoneyType
    Points
    optional
    The number of Amazon Points offered with the purchase of an item.Points
    sellerId
    optional
    The seller identifier for the offer.string

    OfferDetailList

    Type : < OfferDetail > array

    Max items : 20

    OfferDetail

    NameDescriptionSchema
    MyOffer
    optional
    When true, this is the seller's offer.boolean
    offerType
    optional
    Indicates the type of customer that the offer is valid for.OfferCustomerType
    SubCondition
    required
    The subcondition of the item. Subcondition values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.string
    SellerId
    optional
    The seller identifier for the offer.string
    ConditionNotes
    optional
    Information about the condition of the item.string
    SellerFeedbackRating
    optional
    Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received.SellerFeedbackType
    ShippingTime
    required
    The maximum time within which the item will likely be shipped once an order has been placed.DetailedShippingTimeType
    ListingPrice
    required
    The price of the item.MoneyType
    quantityDiscountPrices
    optional
    -< QuantityDiscountPriceType > array
    Points
    optional
    The number of Amazon Points offered with the purchase of an item.Points
    Shipping
    required
    The shipping cost.MoneyType
    ShipsFrom
    optional
    The state and country from where the item is shipped.ShipsFromType
    IsFulfilledByAmazon
    required
    When true, the offer is fulfilled by Amazon.boolean
    PrimeInformation
    optional
    Amazon Prime information.PrimeInformationType
    IsBuyBoxWinner
    optional
    When true, the offer is currently in the Buy Box. There can be up to two Buy Box winners at any time per ASIN, one that is eligible for Prime and one that is not eligible for Prime.boolean
    IsFeaturedMerchant
    optional
    When true, the seller of the item is eligible to win the Buy Box.boolean

    PrimeInformationType

    Amazon Prime information.

    NameDescriptionSchema
    IsPrime
    required
    Indicates whether the offer is an Amazon Prime offer.boolean
    IsNationalPrime
    required
    Indicates whether the offer is an Amazon Prime offer throughout the entire marketplace where it is listed.boolean

    SellerFeedbackType

    Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received.

    NameDescriptionSchema
    SellerPositiveFeedbackRating
    optional
    The percentage of positive feedback for the seller in the past 365 days.number (double)
    FeedbackCount
    required
    The number of ratings received about the seller.integer (int64)

    ErrorList

    A list of error responses returned when a request is unsuccessful.

    Type : < Error > array

    DetailedShippingTimeType

    The time range in which an item will likely be shipped once an order has been placed.

    NameDescriptionSchema
    minimumHours
    optional
    The minimum time, in hours, that the item will likely be shipped after the order has been placed.integer (int64)
    maximumHours
    optional
    The maximum time, in hours, that the item will likely be shipped after the order has been placed.integer (int64)
    availableDate
    optional
    The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping.string
    availabilityType
    optional
    Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. If known, the availableDate property indicates the date that the item will be available for shipping. Possible values: NOW, FUTURE_WITHOUT_DATE, FUTURE_WITH_DATE.enum (AvailabilityType)

    ShipsFromType

    The state and country from where the item is shipped.

    NameDescriptionSchema
    State
    optional
    The state from where the item is shipped.string
    Country
    optional
    The country from where the item is shipped.string

    MarketplaceId

    A marketplace identifier. Specifies the marketplace for which prices are returned.

    Type : string

    ItemCondition

    Type : enum

    For use with the operation(s): getPricing, getListingOffers
    Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

    ValueDescription
    NewNew
    UsedUsed
    CollectibleCollectible
    RefurbishedRefurbished
    ClubClub

    For use with the operation(s): getItemOffers
    Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

    ValueDescription
    NewNew
    UsedUsed
    CollectibleCollectible
    RefurbishedRefurbished
    ClubClub

    CustomerType

    Type : enum

    For use with the operation(s): getCompetitivePricing
    Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

    ValueDescription
    ConsumerConsumer
    BusinessBusiness

    For use with the operation(s): getListingOffers, getItemOffers
    Indicates whether to request Consumer or Business offers. Default is Consumer.

    ValueDescription
    ConsumerConsumer
    BusinessBusiness

    Error

    Error response returned when the request is unsuccessful.

    NameDescriptionSchema
    code
    required
    An error code that identifies the type of error that occurred.string
    message
    required
    A message that describes the error condition in a human-readable form.string
    details
    optional
    Additional information that can help the caller understand or fix the issue.string

    AvailabilityType

    Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. If known, the availableDate property indicates the date that the item will be available for shipping. Possible values: NOW, FUTURE_WITHOUT_DATE, FUTURE_WITH_DATE.

    Type : enum

    ValueDescription
    NOWThe item is available for shipping now.
    FUTURE_WITHOUT_DATEThe item will be available for shipping on an unknown date in the future.
    FUTURE_WITH_DATEThe item will be available for shipping on a known date in the future.

    ItemType

    Type : enum

    For use with the operation(s): getPricing
    Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter.

    ValueDescription
    AsinThe Amazon Standard Identification Number (ASIN).
    SkuThe seller SKU.

    For use with the operation(s): getCompetitivePricing
    Indicates whether ASIN values or seller SKU values are used to identify items. If you specify Asin, the information in the response will be dependent on the list of Asins you provide in the Asins parameter. If you specify Sku, the information in the response will be dependent on the list of Skus you provide in the Skus parameter. Possible values: Asin, Sku.

    ValueDescription
    AsinThe Amazon Standard Identification Number (ASIN).
    SkuThe seller SKU.