API docs by Redocly

Selling Partner API for Pricing (v0)

Download OpenAPI specification:Download

URL: https://sellercentral.amazon.com/gp/mws/contactus.html

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

productPricing

getPricing

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

Usage Plan:

Rate (requests per second) Burst
0.5 1

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.

query Parameters
MarketplaceId
required
string

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

Asins
Array of strings <= 20 items

A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

Skus
Array of strings <= 20 items

A list of up to twenty seller SKU values used to identify items in the given marketplace.

ItemType
required
string
Enum: "Asin" "Sku"

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.

ItemCondition
string
Enum: "New" "Used" "Collectible" "Refurbished" "Club"

Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

OfferType
string
Enum: "B2C" "B2B"

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

Responses

Response samples

Content type
application/json
{
  • "payload": [
    ],
  • "errors": [
    ]
}

getCompetitivePricing

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

Usage Plan:

Rate (requests per second) Burst
0.5 1

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.

query Parameters
MarketplaceId
required
string

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

Asins
Array of strings <= 20 items

A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.

Skus
Array of strings <= 20 items

A list of up to twenty seller SKU values used to identify items in the given marketplace.

ItemType
required
string
Enum: "Asin" "Sku"

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.

CustomerType
string
Enum: "Consumer" "Business"

Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.

Responses

Response samples

Content type
application/json
{
  • "payload": [
    ],
  • "errors": [
    ]
}

getListingOffers

Returns the lowest priced offers for a single SKU listing.

Usage Plan:

Rate (requests per second) Burst
1 2

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.

path Parameters
SellerSKU
required
string

Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.

query Parameters
MarketplaceId
required
string

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

ItemCondition
required
string
Enum: "New" "Used" "Collectible" "Refurbished" "Club"

Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

CustomerType
string
Enum: "Consumer" "Business"

Indicates whether to request Consumer or Business offers. Default is Consumer.

Responses

Response samples

Content type
application/json
{
  • "payload": {
    },
  • "errors": [
    ]
}

getItemOffers

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

Usage Plan:

Rate (requests per second) Burst
0.5 1

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.

path Parameters
Asin
required
string

The Amazon Standard Identification Number (ASIN) of the item.

query Parameters
MarketplaceId
required
string

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

ItemCondition
required
string
Enum: "New" "Used" "Collectible" "Refurbished" "Club"

Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.

CustomerType
string
Enum: "Consumer" "Business"

Indicates whether to request Consumer or Business offers. Default is Consumer.

Responses

Response samples

Content type
application/json
{
  • "payload": {
    },
  • "errors": [
    ]
}

getItemOffersBatch

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

Usage Plan:

Rate (requests per second) Burst
0.5 1

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.

Request Body schema: application/json
Array of objects (ItemOffersRequest) [ 1 .. 20 ] items

A list of getItemOffers batched requests to run.

Responses

Request samples

Content type
application/json
{
  • "requests": [
    ]
}

Response samples

Content type
application/json
{
  • "responses": [
    ]
}

getListingOffersBatch

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

Usage Plan:

Rate (requests per second) Burst
0.5 1

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.

Request Body schema: application/json
Array of objects (ListingOffersRequest) [ 1 .. 20 ] items

A list of getItemOffers batched requests to run.

Responses

Request samples

Content type
application/json
{
  • "requests": [
    ]
}

Response samples

Content type
application/json
{
  • "responses": [
    ]
}