openapi: 3.2.0
info:
title: Amazon Seller Central Product Pricing API
contact:
name: Selling Partner API Developer Support
url: https://sellercentral.amazon.com/gp/mws/contactus.html
license:
name: Apache License 2.0
url: http://www.apache.org/licenses/LICENSE-2.0
version: '1.0'
description: 'Operations tagged productPricing across 2 of this provider''s published API definitions: amazon-seller-central-product-pricing-2022-05-01-original.json, amazon-seller-central-product-pricing-v0-original.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://sellingpartnerapi-na.amazon.com
tags:
- name: productPricing
paths:
/batches/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice:
post:
tags:
- productPricing
description: 'Returns the set of responses that correspond to the batched list of up to 40 requests defined in the request body. The response for each successful (HTTP status code 200) request in the set includes the computed listing price at or below which a seller can expect to become the featured offer (before applicable promotions). This is called the featured offer expected price (FOEP). Featured offer is not guaranteed because competing offers might change. Other offers might be featured based on factors such as fulfillment capabilities to a specific customer. The response to an unsuccessful request includes the available error text.
**Usage Plan:**
| Rate (requests per second) | Burst |
| ---- | ---- |
| 0.033 | 1 |
The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that are applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may receive higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.'
operationId: getFeaturedOfferExpectedPriceBatch
responses:
'200':
description: Success
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- marketplaceId: MARKETPLACE_ID
sku: MY_SKU
segment:
segmentDetails:
sampleLocation:
postalCode:
countryCode: COUNTRY_CODE
value: POSTAL_CODE_VALUE
method: GET
uri: /products/pricing/2022-05-01/offer/featuredOfferExpectedPrice
- marketplaceId: MARKETPLACE_ID
sku: MY_UNIQUE_SKU
method: GET
uri: /products/pricing/2022-05-01/offer/featuredOfferExpectedPrice
- marketplaceId: MARKETPLACE_ID
sku: INVALID_SKU
method: GET
uri: /products/pricing/2022-05-01/offer/featuredOfferExpectedPrice
response:
responses:
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_SKU
segment:
segmentDetails:
sampleLocation:
postalCode:
countryCode: COUNTRY_CODE
value: POSTAL_CODE_VALUE
status:
statusCode: 200
reasonPhrase: Success
headers: {}
body:
offerIdentifier:
asin: ASIN
sku: MY_SKU
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
featuredOfferExpectedPriceResults:
- featuredOfferExpectedPrice:
listingPrice:
amount: 10.0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
resultStatus: VALID_FOEP
competingFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: OTHER_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
currentFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: OTHER_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_UNIQUE_SKU
status:
statusCode: 200
reasonPhrase: Success
headers: {}
body:
offerIdentifier:
asin: ASIN
sku: MY_UNIQUE_SKU
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
featuredOfferExpectedPriceResults:
- resultStatus: NO_COMPETING_OFFERS
currentFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_NONEXISTENT_SKU
status:
statusCode: 400
reasonPhrase: Client Error
headers: {}
body:
errors:
- code: INVALID_SKU
message: The requested SKU does not exist for the seller in the requested Amazon store.
content:
application/json:
schema:
$ref: '#/components/schemas/GetFeaturedOfferExpectedPriceBatchResponse'
example:
responses:
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_SKU
segment:
segmentDetails:
sampleLocation:
postalCode:
countryCode: US
value: '98109'
status:
statusCode: 200
reasonPhrase: Success
headers: {}
body:
offerIdentifier:
asin: ASIN
sku: MY_SKU
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
featuredOfferExpectedPriceResults:
- featuredOfferExpectedPrice:
listingPrice:
amount: 10.0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
resultStatus: VALID_FOEP
competingFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: OTHER_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
currentFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: OTHER_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_UNIQUE_SKU
status:
statusCode: 200
reasonPhrase: Success
headers: {}
body:
offerIdentifier:
asin: ASIN
sku: MY_UNIQUE_SKU
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
featuredOfferExpectedPriceResults:
- resultStatus: NO_COMPETING_OFFERS
currentFeaturedOffer:
offerIdentifier:
asin: ASIN
marketplaceId: MARKETPLACE_ID
fulfillmentType: AFN
sellerId: MY_SELLER_ID
condition: New
price:
listingPrice:
amount: 12.0
currencyCode: USD
shippingPrice:
amount: 0
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
- request:
marketplaceId: MARKETPLACE_ID
sku: MY_NONEXISTENT_SKU
status:
statusCode: 400
reasonPhrase: Client Error
headers: {}
body:
errors:
- code: INVALID_SKU
message: The requested SKU does not exist for the seller in the requested Amazon store.
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- marketplaceId: MARKETPLACE_ID
sku: INVALID_SKU
method: GET
uri: /products/pricing/2022-05-01/offer/featuredOfferExpectedPrice
response:
errors:
- code: INVALID_SKU
message: The requested SKU does not exist for the seller in the requested Amazon store.
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: The request frequency exceeds the allowed rate.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetFeaturedOfferExpectedPriceBatchRequest'
description: The batch of `getFeaturedOfferExpectedPrice` requests.
required: true
summary: Get featured offer expected price batch
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/batches/products/pricing/2022-05-01/items/competitiveSummary:
post:
tags:
- productPricing
description: 'Returns the competitive summary response, including featured buying options for the ASIN and `marketplaceId` combination.
**Usage Plan:**
| Rate (requests per second) | Burst |
| ---- | ---- |
| 0.033 | 1 |
The `x-amzn-RateLimit-Limit` response header returns the usage plan rate limits that are applied to the requested operation, when available. The preceding table contains the default rate and burst values for this operation. Selling partners whose business demands require higher throughput may receive higher rate and burst values than those shown here. For more information, refer to Usage Plans and Rate Limits in the Selling Partner API.'
operationId: getCompetitiveSummary
responses:
'200':
description: Success.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- asin: B00ZIAODGE
marketplaceId: ATVPDKIKX0DER
includedData:
- featuredBuyingOptions
- referencePrices
- lowestPricedOffers
- similarItems
lowestPricedOffersInputs:
- itemCondition: New
offerType: Consumer
- itemCondition: Used
offerType: Consumer
uri: /products/pricing/2022-05-01/items/competitiveSummary
method: GET
- asin: 11_AABB_123
marketplaceId: ATVPDKIKX0DER
includedData:
- featuredBuyingOptions
uri: /products/pricing/2022-05-01/items/competitiveSummary
method: GET
response:
responses:
- status:
statusCode: 200
reasonPhrase: Success
body:
asin: B00ZIAODGE
marketplaceId: ATVPDKIKX0DER
featuredBuyingOptions:
- buyingOptionType: New
segmentedFeaturedOffers:
- sellerId: A3DJR8M9Y3OUPG
condition: New
fulfillmentType: MFN
listingPrice:
amount: 18.11
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
promotions:
- promotionType: COUPON
promotionSavings:
discount:
type: AMOUNT_OFF
amountOff:
amount: 2.0
currencyCode: USD
discountedPrice:
amount: 16.11
currencyCode: USD
featuredOfferSegments:
- customerMembership: NON_PRIME
segmentDetails:
glanceViewWeightPercentage: 72
sampleLocation:
postalCode:
countryCode: US
value: '67890'
- customerMembership: PRIME
segmentDetails:
glanceViewWeightPercentage: 10
sampleLocation:
postalCode:
countryCode: US
value: '12345'
- sellerId: A2ZWOLFOFDPJL1
condition: New
fulfillmentType: MFN
listingPrice:
amount: 17.15
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
promotions:
- promotionType: DEAL
promotionSavings:
discountedPrice:
amount: 17.15
currencyCode: USD
featuredOfferSegments:
- customerMembership: NON_PRIME
segmentDetails:
glanceViewWeightPercentage: 18
sampleLocation:
postalCode:
countryCode: US
value: '12345'
referencePrices:
- name: CompetitivePriceThreshold
price:
amount: 18.11
currencyCode: USD
- name: CompetitivePrice
price:
amount: 17.39
currencyCode: USD
- name: WasPrice
price:
amount: 18.49
currencyCode: USD
lowestPricedOffers:
- lowestPricedOffersInput:
itemCondition: New
offerType: Consumer
offers:
- condition: New
listingPrice:
currencyCode: USD
amount: 17.15
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsMonetaryValue:
amount: 0.5
currencyCode: USD
pointsNumber: 50
primeDetails:
eligibility: REGIONAL
subCondition: New
sellerId: A2ZWOLFOFDPJL1
fulfillmentType: MFN
promotions:
- promotionType: COUPON
promotionSavings:
discount:
type: PERCENTAGE_OFF
percentOff: 10
discountedPrice:
amount: 16.29
currencyCode: USD
- condition: New
listingPrice:
amount: 18.11
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
primeDetails:
eligibility: NATIONAL
sellerId: A3DJR8M9Y3OUPG
subCondition: New
fulfillmentType: MFN
promotions:
- promotionType: BASKET_BUILDING
promotionSavings:
discount:
type: AMOUNT_OFF
amountOff:
amount: 3.0
currencyCode: USD
purchaseRequirements:
condition:
quantityThreshold:
type: AT_LEAST
quantity: 2
- lowestPricedOffersInput:
itemCondition: Used
offerType: Consumer
offers:
- condition: Used
listingPrice:
currencyCode: USD
amount: 12.0
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
primeDetails:
eligibility: REGIONAL
subCondition: Acceptable
sellerId: A3DH5AGPM3JVAB
fulfillmentType: AFN
similarItems:
- items:
- asin: B00ZIA513F
- asin: B009DA8GI1
- asin: B00KF8SK3D
- status:
statusCode: 400
reasonPhrase: Client Error
body:
asin: 11_AABB_123
marketplaceId: ATVPDKIKX0DER
errors:
- code: INVALID_ASIN
message: 11_AABB_123 is not a valid ASIN
content:
application/json:
schema:
$ref: '#/components/schemas/CompetitiveSummaryBatchResponse'
example:
responses:
- status:
statusCode: 200
reasonPhrase: Success
body:
asin: B00ZIAODGE
marketplaceId: ATVPDKIKX0DER
featuredBuyingOptions:
- buyingOptionType: New
segmentedFeaturedOffers:
- sellerId: A3DJR8M9Y3OUPG
condition: New
fulfillmentType: MFN
listingPrice:
amount: 18.11
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
promotions:
- promotionType: COUPON
promotionSavings:
discount:
type: AMOUNT_OFF
amountOff:
amount: 2.0
currencyCode: USD
discountedPrice:
amount: 16.11
currencyCode: USD
- promotionType: BASKET_BUILDING
promotionSavings:
discount:
type: PERCENTAGE_OFF
percentOff: 10
purchaseRequirements:
condition:
amountThreshold:
type: AT_LEAST
currency:
amount: 30
currencyCode: USD
featuredOfferSegments:
- customerMembership: PRIME
segmentDetails:
glanceViewWeightPercentage: 72
sampleLocation:
postalCode:
countryCode: US
value: '12345'
- customerMembership: NON_PRIME
segmentDetails:
glanceViewWeightPercentage: 10
sampleLocation:
postalCode:
countryCode: US
value: '67890'
- customerMembership: DEFAULT
segmentDetails:
glanceViewWeightPercentage: 8
sampleLocation:
postalCode:
countryCode: US
value: '98101'
- sellerId: A2ZWOLFOFDPJL1
condition: New
fulfillmentType: MFN
listingPrice:
amount: 17.15
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
promotions:
- promotionType: DEAL
promotionSavings:
discountedPrice:
amount: 17.15
currencyCode: USD
featuredOfferSegments:
- customerMembership: NON_PRIME
segmentDetails:
glanceViewWeightPercentage: 10
sampleLocation:
postalCode:
countryCode: US
value: '12345'
referencePrices:
- name: CompetitivePriceThreshold
price:
amount: 18.11
currencyCode: USD
- name: CompetitivePrice
price:
amount: 17.39
currencyCode: USD
- name: WasPrice
price:
amount: 18.49
currencyCode: USD
lowestPricedOffers:
- lowestPricedOffersInput:
itemCondition: New
offerType: Consumer
offers:
- listingPrice:
currencyCode: USD
amount: 17.15
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsMonetaryValue:
amount: 0.5
currencyCode: USD
pointsNumber: 50
primeDetails:
eligibility: REGIONAL
subCondition: New
sellerId: A2ZWOLFOFDPJL1
fulfillmentType: MFN
promotions:
- promotionType: COUPON
promotionSavings:
discount:
type: PERCENTAGE_OFF
percentOff: 10
discountedPrice:
amount: 16.29
currencyCode: USD
- listingPrice:
amount: 18.11
currencyCode: USD
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
points:
pointsNumber: 3
pointsMonetaryValue:
amount: 0.03
currencyCode: USD
primeDetails:
eligibility: NATIONAL
sellerId: A3DJR8M9Y3OUPG
subCondition: New
fulfillmentType: MFN
promotions:
- promotionType: BASKET_BUILDING
promotionSavings:
discount:
type: AMOUNT_OFF
amountOff:
amount: 3.0
currencyCode: USD
purchaseRequirements:
condition:
quantityThreshold:
type: AT_LEAST
quantity: 1
- lowestPricedOffersInput:
itemCondition: Used
offerType: Consumer
offers:
- listingPrice:
currencyCode: USD
amount: 12.0
shippingOptions:
- shippingOptionType: DEFAULT
price:
amount: 2.5
currencyCode: USD
primeDetails:
eligibility: REGIONAL
subCondition: Acceptable
sellerId: A3DH5AGPM3JVAB
fulfillmentType: AFN
promotions:
- promotionType: DEAL
promotionSavings:
discountedPrice:
amount: 10.0
currencyCode: USD
similarItems:
- items:
- asin: B00ZIA513F
- asin: B009DA8GI1
- asin: B00KF8SK3D
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- asin: 11_AABB_123
marketplaceId: ATVPDKIKX0DER
includedData:
- featuredBuyingOptions
uri: /products/pricing/2022-05-01/items/competitiveSummary
method: GET
response:
errors:
- code: INVALID_ASIN
message: 11_AABB_123 is not a valid ASIN
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: The request frequency exceeds the allowed rate.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/CompetitiveSummaryBatchRequest'
description: The batch of `getCompetitiveSummary` requests.
required: true
summary: Get competitive summary
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/products/pricing/v0/price:
get:
tags:
- productPricing
description: 'Returns pricing information for a seller''s offer listings based on seller SKU or ASIN.
**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.
**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.'
operationId: getPricing
parameters:
- name: MarketplaceId
in: query
description: A marketplace identifier. Specifies the marketplace for which prices are returned.
required: true
schema:
type: string
- name: Asins
in: query
description: A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
required: false
schema:
type: array
items:
type: string
maxItems: 20
- name: Skus
in: query
description: A list of up to twenty seller SKU values used to identify items in the given marketplace.
required: false
schema:
type: array
items:
type: string
maxItems: 20
- name: ItemType
in: query
description: 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.
required: true
x-docgen-enum-table-extension:
- value: Asin
description: The Amazon Standard Identification Number (ASIN).
- value: Sku
description: The seller SKU.
schema:
type: string
enum:
- Asin
- Sku
- name: ItemCondition
in: query
description: 'Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.'
required: false
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
schema:
type: string
enum:
- New
- Used
- Collectible
- Refurbished
- Club
- name: OfferType
in: query
description: Indicates whether to request pricing information for the seller's B2C or B2B offers. Default is B2C.
required: false
x-docgen-enum-table-extension:
- value: B2C
description: B2C
- value: B2B
description: B2B
schema:
type: string
enum:
- B2C
- B2B
responses:
'200':
description: Success.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Asin
response:
payload:
- status: Success
ASIN: B00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
Offers:
- BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 10.0
LandedPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00V5DG6IQ
- status: Success
ASIN: B00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
Offers:
- BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 10.0
LandedPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00551Q3CS
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Sku
response:
payload:
- status: Success
SellerSKU: NABetaASINB00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ATVPDKIKX0DER
SellerId: AXXXXXXXXXXXXX
SellerSKU: NABetaASINB00V5DG6IQ
Offers:
- BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 10.0
LandedPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00V5DG6IQ
- status: Success
SellerSKU: NABetaASINB00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ATVPDKIKX0DER
SellerId: AXXXXXXXXXXXXX
SellerSKU: NABetaASINB00551Q3CS
Offers:
- BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 10.0
LandedPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00551Q3CS
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Asin
OfferType:
value: B2B
response:
payload:
- status: Success
ASIN: B00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
Offers:
- offerType: B2B
BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 9.5
LandedPrice:
CurrencyCode: USD
Amount: 9.5
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
quantityDiscountPrices:
- quantityTier: 2
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
CurrencyCode: USD
Amount: 8.0
- quantityTier: 3
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
CurrencyCode: USD
Amount: 7.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00V5DG6IQ
- status: Success
ASIN: B00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
Offers:
- offerType: B2B
BuyingPrice:
ListingPrice:
CurrencyCode: USD
Amount: 8.0
LandedPrice:
CurrencyCode: USD
Amount: 8.0
Shipping:
CurrencyCode: USD
Amount: 0.0
RegularPrice:
CurrencyCode: USD
Amount: 10.0
FulfillmentChannel: MERCHANT
ItemCondition: New
ItemSubCondition: New
SellerSKU: NABetaASINB00551Q3CS
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
MarketplaceId:
value: TEST_CASE_400
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
summary: Get pricing
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/products/pricing/v0/competitivePrice:
get:
tags:
- productPricing
description: 'Returns competitive pricing information for a seller''s offer listings based on seller SKU or ASIN.
**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.
**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.'
operationId: getCompetitivePricing
parameters:
- name: MarketplaceId
in: query
description: A marketplace identifier. Specifies the marketplace for which prices are returned.
required: true
schema:
type: string
- name: Asins
in: query
description: A list of up to twenty Amazon Standard Identification Number (ASIN) values used to identify items in the given marketplace.
required: false
schema:
type: array
items:
type: string
maxItems: 20
- name: Skus
in: query
description: A list of up to twenty seller SKU values used to identify items in the given marketplace.
required: false
schema:
type: array
items:
type: string
maxItems: 20
- name: ItemType
in: query
description: '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.'
required: true
x-docgen-enum-table-extension:
- value: Asin
description: The Amazon Standard Identification Number (ASIN).
- value: Sku
description: The seller SKU.
schema:
type: string
enum:
- Asin
- Sku
- name: CustomerType
in: query
description: Indicates whether to request pricing information from the point of view of Consumer or Business buyers. Default is Consumer.
required: false
x-docgen-enum-table-extension:
- value: Consumer
description: Consumer
- value: Business
description: Business
schema:
type: string
enum:
- Consumer
- Business
responses:
'200':
description: Success.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Asin
response:
payload:
- status: Success
ASIN: B00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '4545645646'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 120
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
belongsToRequester: true
NumberOfOfferListings:
- Count: 20
condition: new
TradeInValue:
CurrencyCode: USD
Amount: 10
SalesRankings:
- ProductCategoryId: '325345'
Rank: 1
- status: Success
ASIN: B00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '45456452646'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 120
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
belongsToRequester: true
NumberOfOfferListings:
- Count: 1
condition: new
TradeInValue:
CurrencyCode: string
Amount: 0
SalesRankings:
- ProductCategoryId: '54564'
Rank: 1
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Sku
response:
payload:
- status: Success
SellerSKU: NABetaASINB00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ATVPDKIKX0DER
SellerId: AXXXXXXXXXXXXX
SellerSKU: NABetaASINB00V5DG6IQ
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '3454535'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 120
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
belongsToRequester: true
NumberOfOfferListings:
- Count: 402
condition: new
TradeInValue:
CurrencyCode: USD
Amount: 20
SalesRankings:
- ProductCategoryId: '676554'
Rank: 1
- status: Success
SellerSKU: NABetaASINB00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ATVPDKIKX0DER
SellerId: AXXXXXXXXXXXXX
SellerSKU: NABetaASINB00551Q3CS
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '4545645646'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 120
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
belongsToRequester: true
NumberOfOfferListings:
- Count: 402
condition: new
TradeInValue:
CurrencyCode: USD
Amount: 20
SalesRankings:
- ProductCategoryId: '35345'
Rank: 1
- request:
parameters:
MarketplaceId:
value: ATVPDKIKX0DER
ItemType:
value: Asin
CustomerType:
value: Business
response:
payload:
- status: Success
ASIN: B00V5DG6IQ
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00V5DG6IQ
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '1'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 120
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 10
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
offerType: B2C
sellerId: AXXXXXXXXXXXXX
belongsToRequester: true
- CompetitivePriceId: '1'
Price:
ListingPrice:
CurrencyCode: USD
Amount: 115
condition: new
offerType: B2B
quantityTier: 3
quantityDiscountType: QUANTITY_DISCOUNT
sellerId: AXXXXXXXXXXXXX
belongsToRequester: true
- CompetitivePriceId: '1'
Price:
ListingPrice:
CurrencyCode: USD
Amount: 110
condition: new
offerType: B2B
quantityTier: 5
quantityDiscountType: QUANTITY_DISCOUNT
sellerId: AXXXXXXXXXXXXX
belongsToRequester: true
NumberOfOfferListings:
- Count: 3
condition: new
TradeInValue:
CurrencyCode: USD
Amount: 10
SalesRankings:
- ProductCategoryId: '325345'
Rank: 1
- status: Success
ASIN: B00551Q3CS
Product:
Identifiers:
MarketplaceASIN:
MarketplaceId: ATVPDKIKX0DER
ASIN: B00551Q3CS
SKUIdentifier:
MarketplaceId: ''
SellerId: ''
SellerSKU: ''
CompetitivePricing:
CompetitivePrices:
- CompetitivePriceId: '1'
Price:
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 130
Shipping:
CurrencyCode: USD
Amount: 120
Points:
PointsNumber: 130
PointsMonetaryValue:
CurrencyCode: USD
Amount: 10
condition: new
offerType: B2B
sellerId: AXXXXXXXXXXXXX
belongsToRequester: true
NumberOfOfferListings:
- Count: 1
condition: new
TradeInValue:
CurrencyCode: string
Amount: 0
SalesRankings:
- ProductCategoryId: '54564'
Rank: 1
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
MarketplaceId:
value: TEST_CASE_400
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetPricingResponse'
summary: Get competitive pricing
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/products/pricing/v0/listings/{SellerSKU}/offers:
get:
tags:
- productPricing
description: 'Returns the lowest priced offers for a single SKU listing.
**Note:** The parameters associated with this operation may contain special characters that require URL encoding to call the API. To avoid errors with SKUs when encoding URLs, refer to URL Encoding.
**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.'
operationId: getListingOffers
parameters:
- name: MarketplaceId
in: query
description: A marketplace identifier. Specifies the marketplace for which prices are returned.
required: true
schema:
type: string
- name: ItemCondition
in: query
description: 'Filters the offer listings based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.'
required: true
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
schema:
type: string
enum:
- New
- Used
- Collectible
- Refurbished
- Club
- name: SellerSKU
in: path
description: Identifies an item in the given marketplace. SellerSKU is qualified by the seller's SellerId, which is included with every operation that you submit.
required: true
schema:
type: string
- name: CustomerType
in: query
description: Indicates whether to request Consumer or Business offers. Default is Consumer.
required: false
x-docgen-enum-table-extension:
- value: Consumer
description: Consumer
- value: Business
description: Business
schema:
type: string
enum:
- Consumer
- Business
responses:
'200':
description: Success.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
SellerSKU:
value: NABetaASINB00V5DG6IQ
MarketplaceId:
value: ATVPDKIKX0DER
response:
payload:
SKU: NABetaASINB00V5DG6IQ
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: NABetaASINB00V5DG6IQ
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
TotalOfferCount: 1
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
SellerFeedbackRating:
FeedbackCount: 0
SellerPositiveFeedbackRating: 0.0
ShipsFrom:
State: WA
Country: US
SubCondition: new
IsFeaturedMerchant: false
SellerId: AXXXXXXXXXXXXX
MyOffer: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
- request:
parameters:
SellerSKU:
value: NABetaASINB00V5DG6IQ
MarketplaceId:
value: ATVPDKIKX0DER
CustomerType:
value: Business
response:
payload:
SKU: NABetaASINB00V5DG6IQ
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: NABetaASINB00V5DG6IQ
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
LandedPrice:
CurrencyCode: USD
Amount: 10.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
quantityTier: 20
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
CurrencyCode: USD
Amount: 8.0
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
quantityTier: 30
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
CurrencyCode: USD
Amount: 6.0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxPrices:
- condition: new
offerType: B2B
ListingPrice:
Amount: 9.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 9.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
- condition: new
offerType: B2B
quantityTier: 20
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
Amount: 8.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 8.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
- condition: new
offerType: B2B
quantityTier: 30
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
Amount: 7.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 7.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
TotalOfferCount: 4
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
quantityDiscountPrices:
- quantityTier: 2
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
Amount: 8.0
CurrencyCode: USD
- quantityTier: 3
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
Amount: 7.0
CurrencyCode: USD
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
SellerFeedbackRating:
FeedbackCount: 0
SellerPositiveFeedbackRating: 0.0
ShipsFrom:
State: WA
Country: US
SubCondition: new
IsFeaturedMerchant: false
SellerId: AXXXXXXXXXXXXX
MyOffer: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
SellerSKU:
value: TEST_CASE_400
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
summary: Get listing offers
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/products/pricing/v0/items/{Asin}/offers:
get:
tags:
- productPricing
description: '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.'
operationId: getItemOffers
parameters:
- name: MarketplaceId
in: query
description: A marketplace identifier. Specifies the marketplace for which prices are returned.
required: true
schema:
type: string
- name: ItemCondition
in: query
description: 'Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.'
required: true
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
schema:
type: string
enum:
- New
- Used
- Collectible
- Refurbished
- Club
- name: Asin
in: path
description: The Amazon Standard Identification Number (ASIN) of the item.
required: true
schema:
type: string
- name: CustomerType
in: query
description: Indicates whether to request Consumer or Business offers. Default is Consumer.
required: false
x-docgen-enum-table-extension:
- value: Consumer
description: Consumer
- value: Business
description: Business
schema:
type: string
enum:
- Consumer
- Business
responses:
'200':
description: Success.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
Asin:
value: B00V5DG6IQ
MarketplaceId:
value: ATVPDKIKX0DER
response:
payload:
ASIN: B00V5DG6IQ
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B00V5DG6IQ
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
TotalOfferCount: 1
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
SellerFeedbackRating:
FeedbackCount: 0
SellerPositiveFeedbackRating: 0.0
ShipsFrom:
State: WA
Country: US
SubCondition: new
IsFeaturedMerchant: false
SellerId: AXXXXXXXXXXXXX
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
- request:
parameters:
Asin:
value: B00V5DG6IQ
MarketplaceId:
value: ATVPDKIKX0DER
CustomerType:
value: Business
response:
payload:
ASIN: B00V5DG6IQ
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B00V5DG6IQ
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
LandedPrice:
CurrencyCode: USD
Amount: 10.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
Shipping:
CurrencyCode: USD
Amount: 0.0
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
quantityTier: 20
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
CurrencyCode: USD
Amount: 8.0
- condition: new
fulfillmentChannel: Merchant
offerType: B2B
quantityTier: 30
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
CurrencyCode: USD
Amount: 6.0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
BuyBoxPrices:
- condition: new
offerType: B2B
ListingPrice:
Amount: 9.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 9.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
- condition: new
offerType: B2B
quantityTier: 20
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
Amount: 8.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 8.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
- condition: new
offerType: B2B
quantityTier: 30
quantityDiscountType: QUANTITY_DISCOUNT
ListingPrice:
Amount: 7.0
CurrencyCode: USD
Shipping:
Amount: 0.0
CurrencyCode: USD
LandedPrice:
Amount: 7.0
CurrencyCode: USD
sellerId: AXXXXXXXXXXXXX
TotalOfferCount: 4
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0.0
ListingPrice:
CurrencyCode: USD
Amount: 10.0
quantityDiscountPrices:
- quantityTier: 20
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
Amount: 8.0
CurrencyCode: USD
- quantityTier: 30
quantityDiscountType: QUANTITY_DISCOUNT
listingPrice:
Amount: 7.0
CurrencyCode: USD
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
SellerFeedbackRating:
FeedbackCount: 0
SellerPositiveFeedbackRating: 0.0
ShipsFrom:
State: WA
Country: US
SubCondition: new
IsFeaturedMerchant: false
SellerId: AXXXXXXXXXXXXX
MyOffer: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
Asin:
value: TEST_CASE_400
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetOffersResponse'
summary: Get item offers
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/batches/products/pricing/v0/itemOffers:
post:
tags:
- productPricing
description: 'Returns the lowest priced offers for a batch of items based on ASIN.
**Usage Plan:**
| Rate (requests per second) | Burst |
| ---- | ---- |
| 0.1 | 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.'
operationId: getItemOffersBatch
responses:
'200':
description: Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- uri: /products/pricing/v0/items/B000P6Q7MY/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B001Q3KU9Q/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B007Z07UK6/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B000OQA3N4/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B07PTMKYS7/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B001PYUTII/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B00505DW2I/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B00CGZQU42/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B01LY2ZYRF/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/items/B00KFRNZY6/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
response:
responses:
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B000P6Q7MY
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B000P6Q7MY
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 21
ListingPrice:
CurrencyCode: USD
Amount: 21
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 21
ListingPrice:
CurrencyCode: USD
Amount: 21
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 1
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 1
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 48602
- ProductCategoryId: '166064011'
Rank: 1168
- ProductCategoryId: '251920011'
Rank: 1304
ListPrice:
CurrencyCode: USD
Amount: 26
TotalOfferCount: 1
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 21
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 2889aa8a-77b4-4d11-99f9-5fc24994dc0f
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B000P6Q7MY
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B001Q3KU9Q
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B001Q3KU9Q
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Amazon
LandedPrice:
CurrencyCode: USD
Amount: 24.99
ListingPrice:
CurrencyCode: USD
Amount: 24.99
Shipping:
CurrencyCode: USD
Amount: 0
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 20.49
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 10.49
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 24.99
ListingPrice:
CurrencyCode: USD
Amount: 24.99
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 0
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 6674
- ProductCategoryId: '251947011'
Rank: 33
- ProductCategoryId: '23627232011'
Rank: 41
- ProductCategoryId: '251913011'
Rank: 88
ListPrice:
CurrencyCode: USD
Amount: 27.99
TotalOfferCount: 2
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 24.99
ShippingTime:
maximumHours: 0
minimumHours: 0
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: A1OHOT6VONX3KA
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: true
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 5ff728ac-8f9c-4caa-99a7-704f898eec9c
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B001Q3KU9Q
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B007Z07UK6
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B007Z07UK6
Summary:
LowestPrices:
- condition: used
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 18
ListingPrice:
CurrencyCode: USD
Amount: 11
Shipping:
CurrencyCode: USD
Amount: 7
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 1
ListingPrice:
CurrencyCode: USD
Amount: 1
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 5.01
Shipping:
CurrencyCode: USD
Amount: 4.99
NumberOfOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 2
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 11
BuyBoxEligibleOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 2
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 0
- condition: new
fulfillmentChannel: Merchant
OfferCount: 2
SalesRankings:
- ProductCategoryId: fashion_display_on_website
Rank: 34481
- ProductCategoryId: '3421050011'
Rank: 24
ListPrice:
CurrencyCode: USD
Amount: 10
TotalOfferCount: 14
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 1
ShippingTime:
maximumHours: 720
minimumHours: 504
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AFQSGY2BVBPU2
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 3.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: ARLPNLRVRA0WL
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3QO25ZNO05UF8
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: AQBXQGCOQTJS6
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: ATAQTPUEAJ499
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 4.99
ListingPrice:
CurrencyCode: USD
Amount: 5.01
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AEMQJEQHIGU8X
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3GAR3KWWUHTHC
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2YE02EFDC36RW
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A17VVVVNIJPQI4
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: false
SubCondition: new
SellerId: A3ALR9P0658YQT
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 100
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A35LOCZQ3NFRAA
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: ab062f54-6b1c-4eab-9c59-f9c85847c3cc
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B007Z07UK6
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B000OQA3N4
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B000OQA3N4
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 3
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 0
SalesRankings:
- ProductCategoryId: sports_display_on_website
Rank: 232244
- ProductCategoryId: '3395921'
Rank: 242
- ProductCategoryId: '19574752011'
Rank: 1579
ListPrice:
CurrencyCode: USD
Amount: 25
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3TH9S8BH6GOGM
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 3.99
ListingPrice:
CurrencyCode: USD
Amount: 9.99
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A09263691NO8MK5LA75X2
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 110f73fc-463d-4a68-a042-3a675ee37367
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B000OQA3N4
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B07PTMKYS7
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B07PTMKYS7
Summary:
LowestPrices:
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 200
ListingPrice:
CurrencyCode: USD
Amount: 200
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 12
ListingPrice:
CurrencyCode: USD
Amount: 12
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 2
BuyBoxEligibleOffers:
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 0
- condition: new
fulfillmentChannel: Merchant
OfferCount: 0
SalesRankings:
- ProductCategoryId: video_games_display_on_website
Rank: 2597
- ProductCategoryId: '19497044011'
Rank: 33
- ProductCategoryId: '14670126011'
Rank: 45
ListPrice:
CurrencyCode: USD
Amount: 399
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3TH9S8BH6GOGM
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: f5b23d61-455e-40c4-b615-ca03fd0a25de
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B07PTMKYS7
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B001PYUTII
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B001PYUTII
Summary:
LowestPrices:
- condition: used
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 1
ListingPrice:
CurrencyCode: USD
Amount: 1
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Amazon
LandedPrice:
CurrencyCode: USD
Amount: 17.99
ListingPrice:
CurrencyCode: USD
Amount: 17.99
Shipping:
CurrencyCode: USD
Amount: 0
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 20
ListingPrice:
CurrencyCode: USD
Amount: 20
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 0.5
ListingPrice:
CurrencyCode: USD
Amount: 0.5
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 4270
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 14
BuyBoxEligibleOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 8
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 0
- condition: new
fulfillmentChannel: Merchant
OfferCount: 2
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 30959
- ProductCategoryId: '196604011'
Rank: 94
- ProductCategoryId: '251910011'
Rank: 13863
ListPrice:
CurrencyCode: USD
Amount: 17.99
TotalOfferCount: 4286
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 0.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A21GPS04ENK3GH
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 9
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1NHJ2GQHJYKDD
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1EZPZGQPCQEQR
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2BSRKTUYRBQX7
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12.99
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A14RRT8J7KHRG0
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 5
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A29DD74D3MDLD3
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 15
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1EZPZGQPCQEQR
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 17.99
ShippingTime:
maximumHours: 0
minimumHours: 0
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: A1OHOT6VONX3KA
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: true
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 23
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2NO69NJS5R7BW
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 23
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3J2OPDM7RLS9A
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AA7AN6LI5ZZMD
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 5
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A29DD74D3MDLD3
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3D4MFKTUUP0RS
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 1400
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A16ZGNLKQR74W7
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 5b4ebbf3-cd9f-4e5f-a252-1aed3933ae0e
Date: Tue, 28 Jun 2022 14:21:25 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B001PYUTII
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B00505DW2I
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B00505DW2I
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 14.99
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 4.99
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 14.99
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 4.99
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 3
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 3
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 6581
- ProductCategoryId: '14194715011'
Rank: 11
- ProductCategoryId: '251975011'
Rank: 15
ListPrice:
CurrencyCode: USD
Amount: 36
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 4.99
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A5LI4TEX5CN80
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 15
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 33
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AH2OYH1RAT8PM
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: da27fbae-3066-44b5-8f08-d472152eea0b
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B00505DW2I
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B00CGZQU42
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B00CGZQU42
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Amazon
LandedPrice:
CurrencyCode: USD
Amount: 100
ListingPrice:
CurrencyCode: USD
Amount: 100
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 50
ListingPrice:
CurrencyCode: USD
Amount: 50
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 50
ListingPrice:
CurrencyCode: USD
Amount: 50
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 2
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 1
SalesRankings:
- ProductCategoryId: fashion_display_on_website
Rank: 1093666
- ProductCategoryId: '1045012'
Rank: 2179
ListPrice:
CurrencyCode: USD
Amount: 18.99
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3CTKJEUROOISL
IsFeaturedMerchant: false
IsBuyBoxWinner: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 100
ShippingTime:
maximumHours: 0
minimumHours: 0
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: A16V258PS36Q2H
IsFeaturedMerchant: true
IsBuyBoxWinner: false
IsFulfilledByAmazon: true
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 057b337c-3c17-4bbd-9bbf-79c1ef756dc0
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B00CGZQU42
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B01LY2ZYRF
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B01LY2ZYRF
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 22
ListingPrice:
CurrencyCode: USD
Amount: 22
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 22
ListingPrice:
CurrencyCode: USD
Amount: 22
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 1
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 1
ListPrice:
CurrencyCode: USD
Amount: 59.5
TotalOfferCount: 1
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 22
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: true
IsBuyBoxWinner: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 196a1220-82c4-4b07-8a73-a7d92511f6ef
Date: Tue, 28 Jun 2022 14:21:22 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B01LY2ZYRF
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
ASIN: B00KFRNZY6
status: NoBuyableOffers
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
ASIN: B00KFRNZY6
Summary:
TotalOfferCount: 0
Offers: []
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 7e49bdbb-7347-46fe-8c66-beb7b9c08118
Date: Tue, 28 Jun 2022 14:21:23 GMT
request:
MarketplaceId: ATVPDKIKX0DER
Asin: B00KFRNZY6
CustomerType: Consumer
ItemCondition: New
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetItemOffersBatchResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- uri: /products/pricing/v0/items/B000P6Q7MY/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetItemOffersBatchRequest'
description: The request associated with the `getItemOffersBatch` API call.
required: true
summary: Get item offers batch
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
/batches/products/pricing/v0/listingOffers:
post:
tags:
- productPricing
description: '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.'
operationId: getListingOffersBatch
responses:
'200':
description: Indicates that requests were run in batch. Check the batch response status lines for information on whether a batch request succeeded.
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- uri: /products/pricing/v0/listings/GC-QTMS-SV2I/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/listings/VT-DEIT-57TQ/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/listings/NA-H7X1-JYTM/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/listings/RL-JVOC-MBSL/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
- uri: /products/pricing/v0/listings/74-64KG-H9W9/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
response:
responses:
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
SKU: GC-QTMS-SV2I
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: GC-QTMS-SV2I
Summary:
LowestPrices:
- condition: used
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 1
ListingPrice:
CurrencyCode: USD
Amount: 1
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Amazon
LandedPrice:
CurrencyCode: USD
Amount: 17.99
ListingPrice:
CurrencyCode: USD
Amount: 17.99
Shipping:
CurrencyCode: USD
Amount: 0
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 20
ListingPrice:
CurrencyCode: USD
Amount: 20
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 0.5
ListingPrice:
CurrencyCode: USD
Amount: 0.5
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 4270
- condition: new
fulfillmentChannel: Amazon
OfferCount: 1
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 14
BuyBoxEligibleOffers:
- condition: used
fulfillmentChannel: Merchant
- condition: new
fulfillmentChannel: Amazon
- condition: collectible
fulfillmentChannel: Merchant
- condition: new
fulfillmentChannel: Merchant
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 30959
- ProductCategoryId: '196604011'
Rank: 94
- ProductCategoryId: '251910011'
Rank: 13863
ListPrice:
CurrencyCode: USD
Amount: 17.99
TotalOfferCount: 4286
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 0.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A21GPS04ENK3GH
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 9
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1NHJ2GQHJYKDD
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1EZPZGQPCQEQR
IsFeaturedMerchant: true
IsBuyBoxWinner: true
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2BSRKTUYRBQX7
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12.99
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A14RRT8J7KHRG0
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 5
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A29DD74D3MDLD3
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 15
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A1EZPZGQPCQEQR
IsFeaturedMerchant: true
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 17.99
ShippingTime:
maximumHours: 0
minimumHours: 0
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: A1OHOT6VONX3KA
IsFeaturedMerchant: true
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: true
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 23
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2NO69NJS5R7BW
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 23
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3J2OPDM7RLS9A
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AA7AN6LI5ZZMD
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 5
ListingPrice:
CurrencyCode: USD
Amount: 30
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A29DD74D3MDLD3
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3D4MFKTUUP0RS
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 1400
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A16ZGNLKQR74W7
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: ffd73923-1728-4d57-a45b-8e07a5e10366
Date: Tue, 28 Jun 2022 14:18:08 GMT
request:
MarketplaceId: ATVPDKIKX0DER
SellerSKU: GC-QTMS-SV2I
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
SKU: VT-DEIT-57TQ
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: VT-DEIT-57TQ
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 14.99
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 4.99
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 14.99
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 4.99
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 3
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
SalesRankings:
- ProductCategoryId: toy_display_on_website
Rank: 6581
- ProductCategoryId: '14194715011'
Rank: 11
- ProductCategoryId: '251975011'
Rank: 15
ListPrice:
CurrencyCode: USD
Amount: 36
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 4.99
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A5LI4TEX5CN80
IsFeaturedMerchant: true
IsBuyBoxWinner: true
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 15
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: true
IsBuyBoxWinner: false
MyOffer: true
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 33
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AH2OYH1RAT8PM
IsFeaturedMerchant: true
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 96372776-dae8-4cd3-8edf-c9cd2d708c0c
Date: Tue, 28 Jun 2022 14:18:05 GMT
request:
MarketplaceId: ATVPDKIKX0DER
SellerSKU: VT-DEIT-57TQ
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
SKU: NA-H7X1-JYTM
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: NA-H7X1-JYTM
Summary:
LowestPrices:
- condition: used
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 18
ListingPrice:
CurrencyCode: USD
Amount: 11
Shipping:
CurrencyCode: USD
Amount: 7
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 1
ListingPrice:
CurrencyCode: USD
Amount: 1
Shipping:
CurrencyCode: USD
Amount: 0
BuyBoxPrices:
- condition: new
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 5.01
Shipping:
CurrencyCode: USD
Amount: 4.99
NumberOfOffers:
- condition: used
fulfillmentChannel: Merchant
OfferCount: 2
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 11
BuyBoxEligibleOffers:
- condition: used
fulfillmentChannel: Merchant
- condition: collectible
fulfillmentChannel: Merchant
- condition: new
fulfillmentChannel: Merchant
SalesRankings:
- ProductCategoryId: fashion_display_on_website
Rank: 34481
- ProductCategoryId: '3421050011'
Rank: 24
ListPrice:
CurrencyCode: USD
Amount: 10
TotalOfferCount: 14
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 1
ShippingTime:
maximumHours: 720
minimumHours: 504
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AFQSGY2BVBPU2
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 3.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: ARLPNLRVRA0WL
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3QO25ZNO05UF8
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: true
SubCondition: new
SellerId: AQBXQGCOQTJS6
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 5.5
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: ATAQTPUEAJ499
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 4.99
ListingPrice:
CurrencyCode: USD
Amount: 5.01
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: AEMQJEQHIGU8X
IsFeaturedMerchant: true
IsBuyBoxWinner: true
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3GAR3KWWUHTHC
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2YE02EFDC36RW
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A17VVVVNIJPQI4
IsFeaturedMerchant: true
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 50
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: true
IsNationalPrime: false
SubCondition: new
SellerId: A3ALR9P0658YQT
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 100
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A35LOCZQ3NFRAA
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 0160ecba-a238-40ba-8ef9-647e9a0baf55
Date: Tue, 28 Jun 2022 14:18:05 GMT
request:
MarketplaceId: ATVPDKIKX0DER
SellerSKU: NA-H7X1-JYTM
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
SKU: RL-JVOC-MBSL
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: RL-JVOC-MBSL
Summary:
LowestPrices:
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 10
ListingPrice:
CurrencyCode: USD
Amount: 10
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: new
fulfillmentChannel: Merchant
OfferCount: 3
BuyBoxEligibleOffers:
- condition: new
fulfillmentChannel: Merchant
SalesRankings:
- ProductCategoryId: sports_display_on_website
Rank: 232244
- ProductCategoryId: '3395921'
Rank: 242
- ProductCategoryId: '19574752011'
Rank: 1579
ListPrice:
CurrencyCode: USD
Amount: 25
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 10
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3TH9S8BH6GOGM
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 3.99
ListingPrice:
CurrencyCode: USD
Amount: 9.99
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A09263691NO8MK5LA75X2
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 09d9fb32-661e-44f3-ac59-b2f91bb3d88e
Date: Tue, 28 Jun 2022 14:18:05 GMT
request:
MarketplaceId: ATVPDKIKX0DER
SellerSKU: RL-JVOC-MBSL
CustomerType: Consumer
ItemCondition: New
- status:
statusCode: 200
reasonPhrase: OK
body:
payload:
SKU: 74-64KG-H9W9
status: Success
ItemCondition: New
Identifier:
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
SellerSKU: 74-64KG-H9W9
Summary:
LowestPrices:
- condition: collectible
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 200
ListingPrice:
CurrencyCode: USD
Amount: 200
Shipping:
CurrencyCode: USD
Amount: 0
- condition: new
fulfillmentChannel: Merchant
LandedPrice:
CurrencyCode: USD
Amount: 12
ListingPrice:
CurrencyCode: USD
Amount: 12
Shipping:
CurrencyCode: USD
Amount: 0
NumberOfOffers:
- condition: collectible
fulfillmentChannel: Merchant
OfferCount: 1
- condition: new
fulfillmentChannel: Merchant
OfferCount: 2
BuyBoxEligibleOffers:
- condition: collectible
fulfillmentChannel: Merchant
- condition: new
fulfillmentChannel: Merchant
SalesRankings:
- ProductCategoryId: video_games_display_on_website
Rank: 2597
- ProductCategoryId: '19497044011'
Rank: 33
- ProductCategoryId: '14670126011'
Rank: 45
ListPrice:
CurrencyCode: USD
Amount: 399
TotalOfferCount: 3
Offers:
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 12
ShippingTime:
maximumHours: 48
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A3TH9S8BH6GOGM
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: false
IsFulfilledByAmazon: false
- Shipping:
CurrencyCode: USD
Amount: 0
ListingPrice:
CurrencyCode: USD
Amount: 20
ShippingTime:
maximumHours: 24
minimumHours: 24
availabilityType: NOW
ShipsFrom:
Country: US
PrimeInformation:
IsPrime: false
IsNationalPrime: false
SubCondition: new
SellerId: A2SNBFWOFW4SWG
IsFeaturedMerchant: false
IsBuyBoxWinner: false
MyOffer: true
IsFulfilledByAmazon: false
marketplaceId: ATVPDKIKX0DER
headers:
x-amzn-RequestId: 0df944c2-6de5-48d1-9c9c-df138c00e797
Date: Tue, 28 Jun 2022 14:18:05 GMT
request:
MarketplaceId: ATVPDKIKX0DER
SellerSKU: 74-64KG-H9W9
CustomerType: Consumer
ItemCondition: New
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/GetListingOffersBatchResponse'
'400':
description: Request has missing or invalid parameters and cannot be parsed.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
x-amzn-api-sandbox:
static:
- request:
parameters:
body:
value:
requests:
- uri: /products/pricing/v0/listings/GC-QTMS-SV2I/offers
method: GET
MarketplaceId: ATVPDKIKX0DER
ItemCondition: New
CustomerType: Consumer
response:
errors:
- code: InvalidInput
message: Invalid Input
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'401':
description: The request's Authorization header is not formatted correctly or does not contain a valid token.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'403':
description: Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'404':
description: The specified resource does not exist.
headers:
x-amzn-RateLimit-Limit:
description: Your rate limit (requests per second) for this operation.
schema:
type: string
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'429':
description: The frequency of requests was greater than allowed.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'500':
description: An unexpected condition occurred that prevented the server from fulfilling the request.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
'503':
description: Temporary overloading or maintenance of the server.
headers:
x-amzn-RequestId:
description: Unique request reference identifier.
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/Errors'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetListingOffersBatchRequest'
description: The request associated with the `getListingOffersBatch` API call.
required: true
summary: Get listing offers batch
x-summary-source: derived
servers:
- url: https://sellingpartnerapi-na.amazon.com
components:
schemas:
FeaturedOfferExpectedPrice:
description: The item price at or below which the target offer may be featured.
type: object
required:
- listingPrice
properties:
listingPrice:
description: A computed listing price at or below which a seller can expect to become the featured offer (before applicable promotions).
$ref: '#/components/schemas/MoneyType'
points:
description: The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points.
$ref: '#/components/schemas/Points'
CompetitiveSummaryBatchRequest:
description: The `competitiveSummary` batch request data.
type: object
required:
- requests
properties:
requests:
description: A batched list of `competitiveSummary` requests.
$ref: '#/components/schemas/CompetitiveSummaryRequestList'
MoneyType:
type: object
properties:
currencyCode:
type: string
description: The currency code in ISO 4217 format.
amount:
type: number
description: The monetary value.
description: Currency type and monetary value schema to demonstrate pricing information.
Points:
type: object
properties:
pointsNumber:
type: integer
format: int32
description: The number of Amazon Points.
pointsMonetaryValue:
description: The monetary value of the Amazon Points.
$ref: '#/components/schemas/MoneyType'
description: The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points.
PrimeDetails:
description: Amazon Prime details.
type: object
required:
- eligibility
properties:
eligibility:
description: Indicates whether the offer is an Amazon Prime offer.
type: string
enum:
- NATIONAL
- REGIONAL
- NONE
x-docgen-enum-table-extension:
- value: NATIONAL
description: Indicates that this offer has Amazon Prime eligibility in all regions within the Amazon store.
- value: REGIONAL
description: Indicates that this offer has Amazon Prime eligibility in some (but not all) regions within the Amazon store.
- value: NONE
description: Indicates that this offer is not an Amazon Prime offer in any region within the Amazon store.
Offer:
description: The offer data of a product.
type: object
required:
- sellerId
- condition
- fulfillmentType
- listingPrice
properties:
sellerId:
type: string
description: The seller identifier for the offer.
condition:
description: Item Condition.
$ref: '#/components/schemas/Condition'
subCondition:
type: string
description: The item subcondition of the offer.
enum:
- New
- Mint
- VeryGood
- Good
- Acceptable
- Poor
- Club
- OEM
- Warranty
- RefurbishedWarranty
- Refurbished
- OpenBox
- Other
x-docgen-enum-table-extension:
- value: New
description: New
- value: Mint
description: Mint
- value: VeryGood
description: VeryGood
- value: Good
description: Good
- value: Acceptable
description: Acceptable
- value: Poor
description: Poor
- value: Club
description: Club
- value: OEM
description: OEM
- value: Warranty
description: Warranty
- value: RefurbishedWarranty
description: RefurbishedWarranty
- value: Refurbished
description: Refurbished
- value: OpenBox
description: OpenBox
- value: Other
description: Other
fulfillmentType:
$ref: '#/components/schemas/FulfillmentType'
description: The fulfillment type for the offer. Possible values are `AFN` (Amazon Fulfillment Network) and `MFN` (Merchant Fulfillment Network).
listingPrice:
description: The offer buying price. This doesn't include shipping, points, or applicable promotions.
$ref: '#/components/schemas/MoneyType'
shippingOptions:
description: A list of shipping options associated with this offer
type: array
items:
$ref: '#/components/schemas/ShippingOption'
points:
description: The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points. Note that the Points element is only returned in Japan (JP).
$ref: '#/components/schemas/Points'
primeDetails:
description: Amazon Prime details.
$ref: '#/components/schemas/PrimeDetails'
promotions:
description: A list of live promotions with this offer
$ref: '#/components/schemas/Promotions'
HttpStatusLine:
description: The HTTP status line associated with the response for an individual request within a batch. For more information, refer to [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html).
type: object
properties:
statusCode:
description: The HTTP response status code.
type: integer
minimum: 100
maximum: 599
reasonPhrase:
description: The HTTP response reason phrase.
type: string
CompetitiveSummaryIncludedData:
type: string
description: The supported data types in the `getCompetitiveSummary` API.
enum:
- featuredBuyingOptions
- referencePrices
- lowestPricedOffers
- similarItems
x-docgen-enum-table-extension:
- value: featuredBuyingOptions
description: Describes the current segmented featured offer information for the item.
- value: referencePrices
description: Provides reference price points for the item, such as the Competitive Price Threshold.
- value: lowestPricedOffers
description: The lowest-priced standard offers that are available for the item in the Amazon store.
- value: similarItems
description: Provides a list of up to 20 ASINs which are similar to the item.
FeaturedOfferExpectedPriceRequestParams:
description: The parameters for an individual request.
type: object
required:
- marketplaceId
- sku
properties:
marketplaceId:
$ref: '#/components/schemas/MarketplaceId'
sku:
$ref: '#/components/schemas/Sku'
segment:
$ref: '#/components/schemas/Segment'
GetFeaturedOfferExpectedPriceBatchResponse:
description: The response schema for the `getFeaturedOfferExpectedPriceBatch` operation.
type: object
properties:
responses:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceResponseList'
PromotionType:
type: string
description: 'Indicates the type of promotion based on the customer-facing experience. Possible values include:
- COUPON: The offer has a live coupon that customers can clip and apply at checkout.
- DEAL: The offer has a live deal (for example, Lightning Deal or Best Deal). Deals are time-limited, require meeting quality criteria, and automatically apply a discount when the customer purchases the item.
- BASKET_BUILDING: The offer has a basket-building (multi-quantity) promotion where customers purchase multiple quantities of the same or different qualifying items to receive a discount on eligible items. Promotions created in Seller Central -> Advertising -> Manage Promotions fall into this category'
FeaturedOfferExpectedPriceResult:
description: The FOEP result data for the requested offer.
type: object
required:
- resultStatus
properties:
featuredOfferExpectedPrice:
$ref: '#/components/schemas/FeaturedOfferExpectedPrice'
resultStatus:
description: The status of the FOEP computation. Possible values include `VALID_FOEP`, `NO_COMPETING_OFFER`, `OFFER_NOT_ELIGIBLE`, `OFFER_NOT_FOUND`, and `ASIN_NOT_ELIGIBLE`. Additional values might be added in the future.
type: string
competingFeaturedOffer:
description: The offer that will likely be the featured offer if the target offer is priced above its FOEP. If the target offer is currently the featured offer, this property will be different than `currentFeaturedOffer`.
$ref: '#/components/schemas/FeaturedOffer'
currentFeaturedOffer:
description: The offer that is currently the featured offer. If the target offer is not currently featured, then this property will be equal to `competingFeaturedOffer`.
$ref: '#/components/schemas/FeaturedOffer'
Price:
type: object
required:
- listingPrice
properties:
listingPrice:
description: The listing price for the item, excluding any promotions.
$ref: '#/components/schemas/MoneyType'
shippingPrice:
description: The shipping cost of the product. Note that the shipping cost is not always available.
$ref: '#/components/schemas/MoneyType'
points:
description: The number of Amazon Points that are offered with the purchase of an item and the monetary value of these points.
$ref: '#/components/schemas/Points'
description: The schema for item's price information, including listing price, shipping price, and Amazon Points.
ErrorList:
type: array
description: A list of error responses that are returned when a request is unsuccessful.
items:
$ref: '#/components/schemas/Error'
Error:
type: object
required:
- code
- message
properties:
code:
type: string
description: An error code that identifies the type of error that occurred.
message:
type: string
description: A message that describes the error condition.
details:
type: string
description: Additional details that can help the caller understand or fix the issue.
description: Error response returned when the request is unsuccessful.
LowestPricedOffer:
description: Describes the lowest priced offers for the specified item condition and offer type.
type: object
required:
- lowestPricedOffersInput
- offers
properties:
lowestPricedOffersInput:
description: The filtering criteria that are used to retrieve the lowest priced offers that correspond to the `lowestPricedOffersInputs` request.
type: object
$ref: '#/components/schemas/LowestPricedOffersInput'
offers:
description: A list of up to 20 lowest priced offers that match the criteria specified in `lowestPricedOffersInput`.
type: array
items:
$ref: '#/components/schemas/Offer'
minItems: 1
maxItems: 20
AmountThreshold:
type: object
description: Amount-based purchase conditions for basket building promotions. Customers must spend a minimum dollar amount.
properties:
type:
type: string
description: Indicates how the amount requirement is evaluated. For spend-based conditions, the supported value is AT_LEAST, meaning the customer must spend at least the specified dollar amount to qualify.
currency:
$ref: '#/components/schemas/MoneyType'
description: Minimum spend amount customers must meet.
required:
- type
- currency
SimilarItems:
description: The summary of similar items for the specified ASIN `marketplaceId` combination.
type: object
properties:
items:
description: A list of similar items for the specified ASIN `marketplaceId` combination.
type: array
items:
$ref: '#/components/schemas/Item'
GetFeaturedOfferExpectedPriceBatchRequest:
description: The request body for the `getFeaturedOfferExpectedPriceBatch` operation.
type: object
properties:
requests:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceRequestList'
HttpUri:
description: The URI associated with the individual APIs that are called as part of the batch request.
type: string
minLength: 6
maxLength: 512
FeaturedOfferExpectedPriceResponseList:
description: A batched list of FOEP responses.
type: array
items:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceResponse'
minItems: 1
SegmentDetails:
description: The details about the segment. The FeaturedOfferExpectedPrice API uses only the sampleLocation portion as input.
type: object
properties:
glanceViewWeightPercentage:
description: The glance view weighted percentage for this segment, which is the glance views for this segment as a percentage of total glance views across all segments for the ASIN. A higher percentage indicates that more Amazon customers receive this offer as the Featured Offer.
type: number
sampleLocation:
$ref: '#/components/schemas/SampleLocation'
description: The representative location that features the offer for the segment.
HttpMethod:
description: The HTTP method associated with an individual request within a batch.
type: string
enum:
- GET
- PUT
- PATCH
- DELETE
- POST
x-docgen-enum-table-extension:
- value: GET
description: GET
- value: PUT
description: PUT
- value: PATCH
description: PATCH
- value: DELETE
description: DELETE
- value: POST
description: POST
CompetitiveSummaryBatchResponse:
description: The response schema for the `competitiveSummaryBatch` operation.
type: object
required:
- responses
properties:
responses:
description: The response list for the `competitiveSummaryBatch` operation.
$ref: '#/components/schemas/CompetitiveSummaryResponseList'
FeaturedOfferExpectedPriceRequestList:
description: A batched list of FOEP requests.
type: array
items:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceRequest'
minItems: 1
CompetitiveSummaryRequest:
description: An individual `competitiveSummary` request for an ASIN and `marketplaceId`.
type: object
required:
- asin
- marketplaceId
- includedData
- method
- uri
properties:
asin:
description: The Amazon Standard Identification Number for the item.
$ref: '#/components/schemas/Asin'
marketplaceId:
$ref: '#/components/schemas/MarketplaceId'
description: An Amazon store identifier.
includedData:
type: array
description: The list of requested competitive pricing data for the product.
items:
$ref: '#/components/schemas/CompetitiveSummaryIncludedData'
minItems: 1
lowestPricedOffersInputs:
type: array
description: The list of `lowestPricedOffersInput` parameters that are used to build `lowestPricedOffers` in the response. This attribute is only valid if `lowestPricedOffers` is requested in `includedData`
items:
$ref: '#/components/schemas/LowestPricedOffersInput'
minItems: 0
maxItems: 5
method:
description: HTTP method type
$ref: '#/components/schemas/HttpMethod'
uri:
description: The URI associated with the individual APIs that are called as part of the batch request. For `getCompetitiveSummary`, this is `/products/pricing/2022-05-01/items/competitiveSummary`.
$ref: '#/components/schemas/HttpUri'
PurchaseCondition:
description: Specifies minimum purchase requirements using quantity-based or amount-based conditions for basket building promotions. Used in purchase requirements to specify conditions within those configurations. Exactly one of quantityThreshold or amountThreshold must be specified.
type: object
properties:
quantityThreshold:
description: Quantity-based purchase conditions for basket building promotions. Customer must purchase at least the specified quantity of items
$ref: '#/components/schemas/QuantityThreshold'
amountThreshold:
description: Amount-based purchase conditions for basket building promotions. Customers must purchase a minimum amount for the promotion to apply
$ref: '#/components/schemas/AmountThreshold'
FeaturedOfferExpectedPriceResponse:
allOf:
- $ref: '#/components/schemas/BatchResponse'
- type: object
required:
- request
properties:
request:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceRequestParams'
description: Use these request parameters to map the response back to the request.
body:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceResponseBody'
description: Schema for an individual FOEP response.
CompetitiveSummaryResponse:
description: The response for the individual `competitiveSummary` request in the batch operation.
type: object
required:
- status
- body
properties:
status:
description: The HTTP status line associated with the response. For more information, refer to [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html).
$ref: '#/components/schemas/HttpStatusLine'
body:
description: The `competitiveSummaryResponse` body for a requested ASIN and `marketplaceId`.
$ref: '#/components/schemas/CompetitiveSummaryResponseBody'
FulfillmentType:
type: string
description: Indicates whether the item is fulfilled by Amazon or by the seller (merchant).
enum:
- AFN
- MFN
x-docgen-enum-table-extension:
- value: AFN
description: Fulfilled by Amazon.
- value: MFN
description: Fulfilled by the seller.
PostalCode:
description: Postal code value with country code
type: object
properties:
countryCode:
description: Country code value
type: string
value:
description: Postal code value
type: string
HttpHeaders:
description: A mapping of additional HTTP headers to send or receive for an individual request within a batch.
type: object
additionalProperties:
type: string
Sku:
description: The seller SKU of the item.
type: string
CompetitiveSummaryResponseList:
description: The response list for the `competitiveSummaryBatch` operation.
type: array
items:
description: The response for the individual `competitiveSummary` request in the batch operation.
$ref: '#/components/schemas/CompetitiveSummaryResponse'
minItems: 1
maxItems: 20
QuantityThreshold:
type: object
description: Quantity-based purchase conditions for basket building promotions.
properties:
type:
type: string
description: 'Indicates how the quantity requirement is evaluated. Possible values include:
- AT_LEAST: The customer must purchase at least the specified quantity of items to qualify for the benefit.
- FOR_EACH: The benefit applies for every group of the specified quantity purchased (for example, the discount applies for each set of 2 items purchased).'
quantity:
type: integer
minimum: 1
description: Number of items required to meet this purchase condition.
required:
- type
- quantity
SegmentedFeaturedOffer:
description: A product offer with segment information indicating where it's featured.
allOf:
- $ref: '#/components/schemas/Offer'
- type: object
description: The list of segment information in which the offer is featured.
required:
- featuredOfferSegments
properties:
featuredOfferSegments:
description: The list of segment information in which the offer is featured.
type: array
items:
$ref: '#/components/schemas/FeaturedOfferSegment'
BatchResponse:
description: The common properties for responses to individual requests within a batch.
type: object
required:
- status
- headers
properties:
headers:
$ref: '#/components/schemas/HttpHeaders'
status:
$ref: '#/components/schemas/HttpStatusLine'
ReferencePrice:
description: The reference price for the specified ASIN `marketplaceId` combination.
type: object
required:
- name
- price
properties:
name:
description: Reference price type (e.g., `CompetitivePriceThreshold`, `WasPrice`, `CompetitivePrice`). For definitions, refer to the [Product Pricing API Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api).
type: string
price:
description: The reference price for the ASIN `marketplaceId` combination.
$ref: '#/components/schemas/MoneyType'
Item:
description: A similar item for the specified ASIN `marketplaceId` combination.
type: object
required:
- asin
properties:
asin:
description: The Amazon identifier for the item.
$ref: '#/components/schemas/Asin'
FeaturedOfferExpectedPriceRequest:
description: An individual FOEP request for a particular SKU.
allOf:
- $ref: '#/components/schemas/BatchRequest'
- $ref: '#/components/schemas/FeaturedOfferExpectedPriceRequestParams'
FeaturedOffer:
type: object
required:
- offerIdentifier
properties:
offerIdentifier:
description: An offer identifier used to identify the merchant of the featured offer. Since this may not belong to the requester, the SKU field is omitted.
$ref: '#/components/schemas/OfferIdentifier'
condition:
description: The item condition.
$ref: '#/components/schemas/Condition'
price:
description: The current active price of the offer.
$ref: '#/components/schemas/Price'
description: Schema for `currentFeaturedOffer` or `competingFeaturedOffer`.
PromotionDiscount:
description: Discount details applied by the promotion.
type: object
properties:
type:
description: The type of discount off, categorized by the customer-facing experience.
$ref: '#/components/schemas/DiscountType'
amountOff:
description: The monetary amount discounted from the original price. Only valid when type is AMOUNT_OFF.
$ref: '#/components/schemas/MoneyType'
percentOff:
description: The percentage discount applied to the original price (1-100). Only valid when type is PERCENTAGE_OFF.
type: number
minimum: 1
maximum: 100
Promotions:
description: A list of live promotions applicable to this offer.
type: array
items:
$ref: '#/components/schemas/Promotion'
HttpBody:
description: Additional HTTP body information that is associated with an individual request within a batch.
additionalProperties: {}
Errors:
type: object
description: A list of error responses returned when a request is unsuccessful.
required:
- errors
properties:
errors:
description: One or more unexpected errors occurred during the operation.
$ref: '#/components/schemas/ErrorList'
ShippingOption:
description: The shipping option available for the offer.
type: object
required:
- shippingOptionType
- price
properties:
shippingOptionType:
description: The type of shipping option.
enum:
- DEFAULT
x-docgen-enum-table-extension:
- value: DEFAULT
description: The estimated shipping cost of the product. Note that the shipping cost is not always available.
price:
description: Shipping price for the offer.
$ref: '#/components/schemas/MoneyType'
FeaturedOfferSegment:
description: Describes the segment in which the offer is featured.
type: object
required:
- customerMembership
- segmentDetails
properties:
customerMembership:
description: The customer membership type that makes up this segment
type: string
enum:
- PRIME
- NON_PRIME
- DEFAULT
x-docgen-enum-table-extension:
- value: PRIME
description: Customers that are Prime members.
- value: NON_PRIME
description: Customers that are not Prime members.
- value: DEFAULT
description: Customers whose Prime membership status is unknown.
segmentDetails:
description: The details about the segment.
$ref: '#/components/schemas/SegmentDetails'
OfferIdentifier:
description: Identifies an offer from a particular seller for a specified ASIN.
type: object
required:
- marketplaceId
- asin
properties:
marketplaceId:
$ref: '#/components/schemas/MarketplaceId'
description: An Amazon store identifier.
sellerId:
type: string
description: The seller identifier for the offer.
sku:
type: string
description: The seller SKU of the item. This will only be present for the target offer, which belongs to the requesting seller.
asin:
$ref: '#/components/schemas/Asin'
description: The Amazon identifier for the item.
fulfillmentType:
$ref: '#/components/schemas/FulfillmentType'
description: The fulfillment type for the offer.
Promotion:
description: A promotion applicable to the offer.
type: object
required:
- promotionType
- promotionSavings
properties:
promotionType:
description: The type of promotion, categorized by the customer-facing experience.
$ref: '#/components/schemas/PromotionType'
promotionSavings:
description: The savings applied by the promotion, including discount amount, percentage off, and discounted price.
$ref: '#/components/schemas/PromotionSavings'
purchaseRequirements:
description: Purchase requirements for BASKET_BUILDING promotions. Defines what customers must buy to qualify.
$ref: '#/components/schemas/PurchaseRequirements'
Asin:
description: The ASIN of the item.
type: string
FeaturedOfferExpectedPriceResultList:
type: array
description: A list of FOEP results for the requested offer.
items:
$ref: '#/components/schemas/FeaturedOfferExpectedPriceResult'
CompetitiveSummaryRequestList:
description: A batched list of `competitiveSummary` requests.
type: array
items:
$ref: '#/components/schemas/CompetitiveSummaryRequest'
minItems: 1
maxItems: 20
FeaturedOfferExpectedPriceResponseBody:
description: The FOEP response data for a requested SKU.
type: object
properties:
offerIdentifier:
description: Metadata that identifies the target offer for which the FOEP result data was computed.
$ref: '#/components/schemas/OfferIdentifier'
featuredOfferExpectedPriceResults:
description: The FOEP results for the requested target offer.
$ref: '#/components/schemas/FeaturedOfferExpectedPriceResultList'
errors:
description: The errors that occurred if the operation wasn't successful (HTTP status code non-200).
$ref: '#/components/schemas/ErrorList'
LowestPricedOffersInput:
description: The input required for building `LowestPricedOffers` data in the response.
type: object
required:
- itemCondition
- offerType
properties:
itemCondition:
type: string
description: The input parameter specifies the `itemCondition` of the offer that is requested for `LowestPricedOffers`. `New` is the default value for `itemCondition`.
$ref: '#/components/schemas/Condition'
offerType:
type: string
description: The input parameter specifies the type of offers requested for `LowestPricedOffers`. This applies to `Consumer` and `Business` offers. `Consumer` is the default `offerType`.
enum:
- Consumer
x-docgen-enum-table-extension:
- value: Consumer
description: An offer that is available to all Amazon customers.
PurchaseRequirements:
description: Purchase requirements that customers must meet to qualify for basket building promotions. Contains the purchase condition (how much to buy). Represents the 'Buy X' portion of Buy X Get Y promotions.
type: object
properties:
condition:
description: Minimum purchase requirement specifying either quantity of items or total spend amount that customers must meet to qualify.
$ref: '#/components/schemas/PurchaseCondition'
PromotionSavings:
description: Details about the savings applied by the promotion.
type: object
properties:
discount:
description: The discount applied by the promotion.
$ref: '#/components/schemas/PromotionDiscount'
discountedPrice:
description: The final price after the promotion is applied.
$ref: '#/components/schemas/MoneyType'
BatchRequest:
description: The common properties for individual requests within a batch.
type: object
required:
- uri
- method
properties:
uri:
description: The URI associated with an individual request within a batch. For `FeaturedOfferExpectedPrice`, this is `/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice`.
type: string
method:
$ref: '#/components/schemas/HttpMethod'
body:
$ref: '#/components/schemas/HttpBody'
headers:
$ref: '#/components/schemas/HttpHeaders'
CompetitiveSummaryResponseBody:
description: The `competitiveSummaryResponse` body for a requested ASIN and `marketplaceId`.
type: object
required:
- asin
- marketplaceId
properties:
asin:
description: The Amazon identifier for the item.
$ref: '#/components/schemas/Asin'
marketplaceId:
$ref: '#/components/schemas/MarketplaceId'
description: An Amazon store identifier.
featuredBuyingOptions:
description: A list of featured buying options for the specified ASIN `marketplaceId` combination.
type: array
items:
$ref: '#/components/schemas/FeaturedBuyingOption'
lowestPricedOffers:
description: A list of lowest priced offers for the specified ASIN `marketplaceId` combination.
type: array
items:
$ref: '#/components/schemas/LowestPricedOffer'
referencePrices:
description: A list of reference prices for the specified ASIN `marketplaceId` combination.
type: array
items:
$ref: '#/components/schemas/ReferencePrice'
similarItems:
description: A list of similar items for the specified ASIN `marketplaceId` combination.
type: array
items:
$ref: '#/components/schemas/SimilarItems'
errors:
description: A list of errors
$ref: '#/components/schemas/ErrorList'
DiscountType:
type: string
description: 'Method used to calculate the discount amount. Supported values: PERCENTAGE_OFF (discount applied as a percentage off the original price), AMOUNT_OFF (discount applied as a fixed amount off the original price).'
Condition:
description: The condition of the item.
type: string
enum:
- New
- Used
- Collectible
- Refurbished
- Club
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
MarketplaceId:
description: The `MarketplaceID` is the globally unique identifier of an Amazon store. To find the ID for your Amazon store, refer to [Amazon store IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
type: string
Segment:
description: Input segment for featured offer expected price. The segment contains the location information for which featured offer expected price is requested.
properties:
segmentDetails:
description: Segment details
$ref: '#/components/schemas/SegmentDetails'
type: object
SampleLocation:
description: Information about a location. It uses a postal code to identify the location.
type: object
properties:
postalCode:
$ref: '#/components/schemas/PostalCode'
FeaturedBuyingOption:
description: Describes a featured buying option, which includes a list of segmented featured offers for a particular item condition.
type: object
required:
- buyingOptionType
- segmentedFeaturedOffers
properties:
buyingOptionType:
description: The buying option type for the featured offer. `buyingOptionType` represents the buying options that a customer receives on the detail page, such as `B2B`, `Fresh`, and `Subscribe n Save`. `buyingOptionType` currently supports `NEW` as a value.
type: string
enum:
- New
x-docgen-enum-table-extension:
- value: New
description: New
segmentedFeaturedOffers:
description: A list of segmented featured offers for the current buying option type. A segment can be considered as a group of regional contexts that all have the same featured offer. A regional context is a combination of factors such as customer type, region, or postal code and buying option.
type: array
items:
$ref: '#/components/schemas/SegmentedFeaturedOffer'
minItems: 1
ListingOffersRequestParams:
allOf:
- $ref: '#/components/schemas/BatchOffersRequestParams'
- type: object
required:
- SellerSKU
properties:
SellerSKU:
type: string
description: The seller stock keeping unit (SKU) of the item. This is the same SKU passed as a path parameter.
description: List of request parameters that can be accepted by `ListingOffersRequest`
CustomerType:
description: Indicates whether to request Consumer or Business offers. Default is Consumer.
type: string
enum:
- Consumer
- Business
x-docgen-enum-table-extension:
- value: Consumer
description: Consumer
- value: Business
description: Business
SalesRankList:
type: array
description: A list of sales rank information for the item, by category.
items:
$ref: '#/components/schemas/SalesRankType'
MoneyType_2:
type: object
properties:
CurrencyCode:
type: string
description: The currency code in ISO 4217 format.
Amount:
type: number
description: The monetary value.
description: Currency type and monetary value. Schema for demonstrating pricing info.
ItemOffersRequestParams:
allOf:
- $ref: '#/components/schemas/BatchOffersRequestParams'
- type: object
properties:
Asin:
type: string
description: The Amazon Standard Identification Number (ASIN) of the item. This is the same Asin passed as a request parameter.
description: List of request parameters that can be accepted by `ItemOffersRequest`
GetPricingResponse:
type: object
properties:
payload:
description: The payload for the getPricing and getCompetitivePricing operations.
$ref: '#/components/schemas/PriceList'
errors:
description: One or more unexpected errors occurred during the operation.
$ref: '#/components/schemas/ErrorList_2'
description: The response schema for the `getPricing` and `getCompetitivePricing` operations.
BatchOffersRequestParams:
type: object
required:
- MarketplaceId
- ItemCondition
properties:
MarketplaceId:
$ref: '#/components/schemas/MarketplaceId_2'
ItemCondition:
description: 'Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.'
$ref: '#/components/schemas/ItemCondition'
CustomerType:
description: Indicates whether to request Consumer or Business offers. Default is Consumer.
$ref: '#/components/schemas/CustomerType'
description: Common request parameters that can be accepted by `ItemOffersRequest` and `ListingOffersRequest`
OfferCountType:
type: object
properties:
condition:
type: string
description: 'Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.'
fulfillmentChannel:
description: Indicates whether the item is fulfilled by Amazon or by the seller.
$ref: '#/components/schemas/FulfillmentChannelType'
OfferCount:
type: integer
format: int32
description: The number of offers in a fulfillment channel that meet a specific condition.
description: The total number of offers for the specified condition and fulfillment channel.
Points_2:
type: object
properties:
PointsNumber:
type: integer
format: int32
description: The number of points.
PointsMonetaryValue:
description: The monetary value of the points.
$ref: '#/components/schemas/MoneyType_2'
description: The number of Amazon Points offered with the purchase of an item, and their monetary value.
ItemOffersRequest:
allOf:
- $ref: '#/components/schemas/BatchRequest_2'
- $ref: '#/components/schemas/BatchOffersRequestParams'
description: List of request parameters can be accepted by `ItemOffersRequests` operation
Summary:
type: object
required:
- TotalOfferCount
properties:
TotalOfferCount:
type: integer
format: int32
description: The number of unique offers contained in NumberOfOffers.
NumberOfOffers:
description: A list that contains the total number of offers for the item for the given conditions and fulfillment channels.
$ref: '#/components/schemas/NumberOfOffers'
LowestPrices:
description: A list of the lowest prices for the item.
$ref: '#/components/schemas/LowestPrices'
BuyBoxPrices:
description: A list of item prices.
$ref: '#/components/schemas/BuyBoxPrices'
ListPrice:
description: The list price of the item as suggested by the manufacturer.
$ref: '#/components/schemas/MoneyType_2'
CompetitivePriceThreshold:
description: 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.
$ref: '#/components/schemas/MoneyType_2'
SuggestedLowerPricePlusShipping:
description: 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.
$ref: '#/components/schemas/MoneyType_2'
SalesRankings:
description: A list that contains the sales rank of the item in the given product categories.
$ref: '#/components/schemas/SalesRankList'
BuyBoxEligibleOffers:
description: A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels.
$ref: '#/components/schemas/BuyBoxEligibleOffers'
OffersAvailableTime:
type: string
format: date-time
description: When the status is ActiveButTooSoonForProcessing, this is the time when the offers will be available for processing.
description: Contains price information about the product, including the LowestPrices and BuyBoxPrices, the ListPrice, the SuggestedLowerPricePlusShipping, and NumberOfOffers and NumberOfBuyBoxEligibleOffers.
BuyBoxPrices:
type: array
items:
$ref: '#/components/schemas/BuyBoxPriceType'
description: A list of the Buy Box prices.
OffersList:
type: array
description: A list of offers.
items:
$ref: '#/components/schemas/OfferType'
GetOffersResponse:
type: object
properties:
payload:
description: The payload for the `getListingOffers` and `getItemOffers` operations.
$ref: '#/components/schemas/GetOffersResult'
errors:
description: One or more unexpected errors occurred during the operation.
$ref: '#/components/schemas/ErrorList_2'
description: The response schema for the `getListingOffers` and `getItemOffers` operations.
NumberOfOffers:
type: array
items:
$ref: '#/components/schemas/OfferCountType'
description: A list that contains the total number of offers information for given conditions and fulfillment channels.
ListingOffersRequest:
allOf:
- $ref: '#/components/schemas/BatchRequest_2'
- $ref: '#/components/schemas/BatchOffersRequestParams'
description: List of request parameters that can be accepted by `ListingOffersRequest` operation
ListingOffersResponse:
allOf:
- $ref: '#/components/schemas/BatchOffersResponse'
- type: object
properties:
request:
$ref: '#/components/schemas/ListingOffersRequestParams'
description: Schema for an individual `ListingOffersResponse`
BatchOffersResponse:
type: object
required:
- body
properties:
headers:
$ref: '#/components/schemas/HttpResponseHeaders'
status:
$ref: '#/components/schemas/GetOffersHttpStatusLine'
body:
$ref: '#/components/schemas/GetOffersResponse'
description: Common schema that present in `ItemOffersResponse` and `ListingOffersResponse`
OfferDetail:
type: object
required:
- IsFulfilledByAmazon
- ListingPrice
- Shipping
- ShippingTime
- SubCondition
properties:
MyOffer:
type: boolean
description: When true, this is the seller's offer.
offerType:
description: Indicates the type of customer that the offer is valid for.
$ref: '#/components/schemas/OfferCustomerType'
SubCondition:
type: string
description: 'The subcondition of the item. Subcondition values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.'
SellerId:
description: The seller identifier for the offer.
type: string
ConditionNotes:
description: Information about the condition of the item.
type: string
SellerFeedbackRating:
description: Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received.
$ref: '#/components/schemas/SellerFeedbackType'
ShippingTime:
description: The maximum time within which the item will likely be shipped once an order has been placed.
$ref: '#/components/schemas/DetailedShippingTimeType'
ListingPrice:
description: The price of the item.
$ref: '#/components/schemas/MoneyType_2'
quantityDiscountPrices:
type: array
items:
$ref: '#/components/schemas/QuantityDiscountPriceType'
description: List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk.
Points:
description: The number of Amazon Points offered with the purchase of an item.
$ref: '#/components/schemas/Points_2'
Shipping:
description: The shipping cost.
$ref: '#/components/schemas/MoneyType_2'
ShipsFrom:
description: The state and country from where the item is shipped.
$ref: '#/components/schemas/ShipsFromType'
IsFulfilledByAmazon:
type: boolean
description: When true, the offer is fulfilled by Amazon.
PrimeInformation:
description: Amazon Prime information.
$ref: '#/components/schemas/PrimeInformationType'
IsBuyBoxWinner:
type: boolean
description: 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.
IsFeaturedMerchant:
type: boolean
description: When true, the seller of the item is eligible to win the Buy Box.
description: Schema for an individual offer. Object in `OfferDetailList`.
Price_2:
type: object
required:
- status
properties:
status:
type: string
description: The status of the operation.
SellerSKU:
type: string
description: The seller stock keeping unit (SKU) of the item.
ASIN:
type: string
description: The Amazon Standard Identification Number (ASIN) of the item.
Product:
$ref: '#/components/schemas/Product'
description: Schema for price info in `getPricing` response
ErrorList_2:
type: array
description: A list of error responses returned when a request is unsuccessful.
items:
$ref: '#/components/schemas/Error'
GetListingOffersBatchRequest:
description: The request associated with the `getListingOffersBatch` API call.
type: object
properties:
requests:
$ref: '#/components/schemas/ListingOffersRequestList'
AttributeSetList:
type: array
description: A list of product attributes if they are applicable to the product that is returned.
items:
type: object
OfferDetailList:
type: array
items:
$ref: '#/components/schemas/OfferDetail'
maxItems: 20
description: A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less.
HttpMethod_2:
description: The HTTP method associated with the individual APIs being called as part of the batch request.
type: string
enum:
- GET
- PUT
- PATCH
- DELETE
- POST
x-docgen-enum-table-extension:
- value: GET
description: GET
- value: PUT
description: PUT
- value: PATCH
description: PATCH
- value: DELETE
description: DELETE
- value: POST
description: POST
QuantityDiscountType:
type: string
enum:
- QUANTITY_DISCOUNT
x-docgen-enum-table-extension:
- value: QUANTITY_DISCOUNT
description: Quantity Discount
description: Indicates the type of quantity discount this price applies to.
OfferType:
type: object
required:
- BuyingPrice
- FulfillmentChannel
- ItemCondition
- ItemSubCondition
- RegularPrice
- SellerSKU
properties:
offerType:
description: Indicates the type of customer that the offer is valid for.
$ref: '#/components/schemas/OfferCustomerType'
BuyingPrice:
description: Contains pricing information that includes promotions and contains the shipping cost.
$ref: '#/components/schemas/PriceType'
RegularPrice:
description: The current price excluding any promotions that apply to the product. Excludes the shipping cost.
$ref: '#/components/schemas/MoneyType_2'
businessPrice:
description: The current listing price for Business buyers.
$ref: '#/components/schemas/MoneyType_2'
quantityDiscountPrices:
type: array
items:
$ref: '#/components/schemas/QuantityDiscountPriceType'
description: List of `QuantityDiscountPrice` that contains item's pricing information when buy in bulk.
FulfillmentChannel:
type: string
description: 'The fulfillment channel for the offer listing. Possible values:
* Amazon - Fulfilled by Amazon.
* Merchant - Fulfilled by the seller.'
ItemCondition:
type: string
description: 'The item condition for the offer listing. Possible values: New, Used, Collectible, Refurbished, or Club.'
ItemSubCondition:
type: string
description: 'The item subcondition for the offer listing. Possible values: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.'
SellerSKU:
type: string
description: The seller stock keeping unit (SKU) of the item.
description: Schema for an individual offer.
QuantityDiscountPriceType:
type: object
description: Contains pricing information that includes special pricing when buying in bulk.
required:
- quantityTier
- quantityDiscountType
- listingPrice
properties:
quantityTier:
type: integer
format: int32
description: Indicates at what quantity this price becomes active.
quantityDiscountType:
description: Indicates the type of quantity discount this price applies to.
$ref: '#/components/schemas/QuantityDiscountType'
listingPrice:
description: The price at this quantity tier.
$ref: '#/components/schemas/MoneyType_2'
GetItemOffersBatchResponse:
description: The response associated with the `getItemOffersBatch` API call.
type: object
properties:
responses:
$ref: '#/components/schemas/ItemOffersResponseList'
ASINIdentifier:
type: object
required:
- ASIN
- MarketplaceId
properties:
MarketplaceId:
type: string
description: A marketplace identifier.
ASIN:
type: string
description: The Amazon Standard Identification Number (ASIN) of the item.
description: Schema to identify an item by MarketPlaceId and ASIN.
ItemOffersRequestList:
description: A list of `getListingOffers` batched requests to run.
type: array
items:
$ref: '#/components/schemas/ItemOffersRequest'
minItems: 1
maxItems: 20
OfferCustomerType:
type: string
enum:
- B2C
- B2B
x-docgen-enum-table-extension:
- value: B2C
description: B2C
- value: B2B
description: B2B
description: Indicates whether the offer is a B2B or B2C offer
NumberOfOfferListingsList:
type: array
description: 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.
items:
$ref: '#/components/schemas/OfferListingCountType'
ListingOffersResponseList:
description: A list of `getListingOffers` batched responses.
type: array
items:
$ref: '#/components/schemas/ListingOffersResponse'
minItems: 1
maxItems: 20
SalesRankType:
type: object
required:
- ProductCategoryId
- Rank
properties:
ProductCategoryId:
type: string
description: ' Identifies the item category from which the sales rank is taken.'
Rank:
type: integer
format: int32
description: The sales rank of the item within the item category.
description: Sales rank information for the item, by category
SellerFeedbackType:
type: object
required:
- FeedbackCount
properties:
SellerPositiveFeedbackRating:
type: number
format: double
description: The percentage of positive feedback for the seller in the past 365 days.
FeedbackCount:
type: integer
format: int64
description: The number of ratings received about the seller.
description: Information about the seller's feedback, including the percentage of positive feedback, and the total number of ratings received.
PrimeInformationType:
description: Amazon Prime information.
type: object
required:
- IsPrime
- IsNationalPrime
properties:
IsPrime:
description: Indicates whether the offer is an Amazon Prime offer.
type: boolean
IsNationalPrime:
description: Indicates whether the offer is an Amazon Prime offer throughout the entire marketplace where it is listed.
type: boolean
ItemOffersResponse:
allOf:
- $ref: '#/components/schemas/BatchOffersResponse'
- type: object
required:
- request
properties:
request:
$ref: '#/components/schemas/ItemOffersRequestParams'
description: Schema for an individual `ItemOffersResponse`
FulfillmentChannelType:
type: string
description: Indicates whether the item is fulfilled by Amazon or by the seller (merchant).
enum:
- Amazon
- Merchant
x-docgen-enum-table-extension:
- value: Amazon
description: Fulfilled by Amazon.
- value: Merchant
description: Fulfilled by the seller.
CompetitivePriceType:
type: object
required:
- CompetitivePriceId
- Price
properties:
CompetitivePriceId:
type: string
description: 'The pricing model for each price that is returned.
Possible values:
* 1 - New Buy Box Price.
* 2 - Used Buy Box Price.'
Price:
description: Pricing information for a given CompetitivePriceId value.
$ref: '#/components/schemas/PriceType'
condition:
type: string
description: 'Indicates the condition of the item whose pricing information is returned. Possible values are: New, Used, Collectible, Refurbished, or Club.'
subcondition:
type: string
description: '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.'
offerType:
description: 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.
$ref: '#/components/schemas/OfferCustomerType'
quantityTier:
type: integer
format: int32
description: Indicates at what quantity this price becomes active.
quantityDiscountType:
description: Indicates the type of quantity discount this price applies to.
$ref: '#/components/schemas/QuantityDiscountType'
sellerId:
type: string
description: The seller identifier for the offer.
belongsToRequester:
type: boolean
description: ' 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.'
description: Schema for competitive pricing information
GetListingOffersBatchResponse:
description: The response associated with the `getListingOffersBatch` API call.
type: object
properties:
responses:
$ref: '#/components/schemas/ListingOffersResponseList'
LowestPriceType:
type: object
required:
- ListingPrice
- condition
- fulfillmentChannel
properties:
condition:
type: string
description: 'Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.'
fulfillmentChannel:
type: string
description: Indicates whether the item is fulfilled by Amazon or by the seller.
offerType:
description: Indicates the type of customer that the offer is valid for.
$ref: '#/components/schemas/OfferCustomerType'
quantityTier:
type: integer
format: int32
description: Indicates at what quantity this price becomes active.
quantityDiscountType:
description: Indicates the type of quantity discount this price applies to.
$ref: '#/components/schemas/QuantityDiscountType'
LandedPrice:
description: The value calculated by adding ListingPrice + Shipping - Points.
$ref: '#/components/schemas/MoneyType_2'
ListingPrice:
description: The price of the item.
$ref: '#/components/schemas/MoneyType_2'
Shipping:
description: The shipping cost.
$ref: '#/components/schemas/MoneyType_2'
Points:
description: The number of Amazon Points offered with the purchase of an item.
$ref: '#/components/schemas/Points_2'
description: Schema for an individual lowest price.
GetItemOffersBatchRequest:
description: The request associated with the `getItemOffersBatch` API call.
type: object
properties:
requests:
$ref: '#/components/schemas/ItemOffersRequestList'
OfferListingCountType:
type: object
required:
- Count
- condition
properties:
Count:
type: integer
format: int32
description: The number of offer listings.
condition:
type: string
description: The condition of the item.
description: The number of offer listings with the specified condition.
LowestPrices:
type: array
items:
$ref: '#/components/schemas/LowestPriceType'
description: A list of the lowest prices.
HttpRequestHeaders:
description: A mapping of additional HTTP headers to send/receive for the individual batch request.
type: object
additionalProperties:
type: string
BuyBoxEligibleOffers:
type: array
items:
$ref: '#/components/schemas/OfferCountType'
description: A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels.
BuyBoxPriceType:
type: object
required:
- LandedPrice
- ListingPrice
- Shipping
- condition
properties:
condition:
type: string
description: 'Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.'
offerType:
description: 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.
$ref: '#/components/schemas/OfferCustomerType'
quantityTier:
type: integer
format: int32
description: Indicates at what quantity this price becomes active.
quantityDiscountType:
description: Indicates the type of quantity discount this price applies to.
$ref: '#/components/schemas/QuantityDiscountType'
LandedPrice:
description: The value calculated by adding ListingPrice + Shipping - Points.
$ref: '#/components/schemas/MoneyType_2'
ListingPrice:
description: The price of the item.
$ref: '#/components/schemas/MoneyType_2'
Shipping:
description: The shipping cost.
$ref: '#/components/schemas/MoneyType_2'
Points:
description: The number of Amazon Points offered with the purchase of an item.
$ref: '#/components/schemas/Points_2'
sellerId:
type: string
description: The seller identifier for the offer.
description: Schema for an individual buybox price.
ListingOffersRequestList:
description: A list of `getListingOffers` batched requests to run.
type: array
items:
$ref: '#/components/schemas/ListingOffersRequest'
minItems: 1
maxItems: 20
SellerSKUIdentifier:
type: object
required:
- MarketplaceId
- SellerId
- SellerSKU
properties:
MarketplaceId:
type: string
description: A marketplace identifier.
SellerId:
type: string
description: The seller identifier submitted for the operation.
SellerSKU:
type: string
description: The seller stock keeping unit (SKU) of the item.
description: Schema to identify an item by MarketPlaceId, SellerId, and SellerSKU.
GetOffersResult:
type: object
required:
- Identifier
- ItemCondition
- Offers
- Summary
- status
- marketplaceId
properties:
marketplaceId:
type: string
description: A marketplace identifier.
ASIN:
type: string
description: The Amazon Standard Identification Number (ASIN) of the item.
SKU:
type: string
description: The stock keeping unit (SKU) of the item.
ItemCondition:
description: The condition of the item.
$ref: '#/components/schemas/ConditionType'
status:
type: string
description: The status of the operation.
Identifier:
description: Metadata that identifies the item.
$ref: '#/components/schemas/ItemIdentifier'
Summary:
description: Pricing information about the item.
$ref: '#/components/schemas/Summary'
Offers:
description: A list of offer details. The list is the same length as the TotalOfferCount in the Summary or 20, whichever is less.
$ref: '#/components/schemas/OfferDetailList'
description: The payload for the getListingOffers and getItemOffers operations.
ItemCondition:
description: 'Filters the offer listings to be considered based on item condition. Possible values: New, Used, Collectible, Refurbished, Club.'
type: string
enum:
- New
- Used
- Collectible
- Refurbished
- Club
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
ShipsFromType:
type: object
properties:
State:
type: string
description: The state from where the item is shipped.
Country:
type: string
description: The country from where the item is shipped.
description: The state and country from where the item is shipped.
IdentifierType:
type: object
required:
- MarketplaceASIN
properties:
MarketplaceASIN:
description: Indicates the item is identified by MarketPlaceId and ASIN.
$ref: '#/components/schemas/ASINIdentifier'
SKUIdentifier:
description: Indicates the item is identified by MarketPlaceId, SellerId, and SellerSKU.
$ref: '#/components/schemas/SellerSKUIdentifier'
description: Specifies the identifiers used to uniquely identify an item.
ConditionType:
type: string
description: 'Indicates the condition of the item. Possible values: New, Used, Collectible, Refurbished, Club.'
enum:
- New
- Used
- Collectible
- Refurbished
- Club
x-docgen-enum-table-extension:
- value: New
description: New
- value: Used
description: Used
- value: Collectible
description: Collectible
- value: Refurbished
description: Refurbished
- value: Club
description: Club
HttpResponseHeaders:
description: A mapping of additional HTTP headers to send/receive for the individual batch request.
type: object
properties:
Date:
type: string
description: The timestamp that the API request was received. For more information, consult [RFC 2616 Section 14](https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html).
x-amzn-RequestId:
type: string
description: Unique request reference identifier.
additionalProperties:
type: string
BatchRequest_2:
description: Common properties of batch requests against individual APIs.
type: object
required:
- uri
- method
properties:
uri:
type: string
description: 'The resource path of the operation you are calling in batch without any query parameters.
If you are calling `getItemOffersBatch`, supply the path of `getItemOffers`.
**Example:** `/products/pricing/v0/items/B000P6Q7MY/offers`
If you are calling `getListingOffersBatch`, supply the path of `getListingOffers`.
**Example:** `/products/pricing/v0/listings/B000P6Q7MY/offers`'
method:
$ref: '#/components/schemas/HttpMethod_2'
headers:
$ref: '#/components/schemas/HttpRequestHeaders'
RelationshipList:
type: array
description: A list that contains product variation information, if applicable.
items:
type: object
ItemIdentifier:
type: object
required:
- ItemCondition
- MarketplaceId
properties:
MarketplaceId:
type: string
description: A marketplace identifier. Specifies the marketplace from which prices are returned.
ASIN:
type: string
description: The Amazon Standard Identification Number (ASIN) of the item.
SellerSKU:
type: string
description: The seller stock keeping unit (SKU) of the item.
ItemCondition:
description: The condition of the item.
$ref: '#/components/schemas/ConditionType'
description: Information that identifies an item.
GetOffersHttpStatusLine:
description: The HTTP status line associated with the response. For more information, consult [RFC 2616](https://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html).
type: object
properties:
statusCode:
description: The HTTP response Status Code.
type: integer
minimum: 100
maximum: 599
reasonPhrase:
description: The HTTP response Reason-Phase.
type: string
Product:
type: object
required:
- Identifiers
properties:
Identifiers:
$ref: '#/components/schemas/IdentifierType'
AttributeSets:
$ref: '#/components/schemas/AttributeSetList'
Relationships:
$ref: '#/components/schemas/RelationshipList'
CompetitivePricing:
$ref: '#/components/schemas/CompetitivePricingType'
SalesRankings:
$ref: '#/components/schemas/SalesRankList'
Offers:
$ref: '#/components/schemas/OffersList'
description: An item.
PriceType:
type: object
required:
- ListingPrice
properties:
LandedPrice:
description: 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.
$ref: '#/components/schemas/MoneyType_2'
ListingPrice:
description: The listing price of the item including any promotions that apply.
$ref: '#/components/schemas/MoneyType_2'
Shipping:
description: The shipping cost of the product. Note that the shipping cost is not always available.
$ref: '#/components/schemas/MoneyType_2'
Points:
description: The number of Amazon Points offered with the purchase of an item, and their monetary value.
$ref: '#/components/schemas/Points_2'
description: Schema for item's price information, including listing price, shipping price, and Amazon points.
PriceList:
type: array
items:
$ref: '#/components/schemas/Price_2'
maxItems: 20
description: The payload for the `getPricing` and `getCompetitivePricing` operations.
CompetitivePriceList:
type: array
description: A list of competitive pricing information.
items:
$ref: '#/components/schemas/CompetitivePriceType'
ItemOffersResponseList:
description: A list of `getItemOffers` batched responses.
type: array
items:
$ref: '#/components/schemas/ItemOffersResponse'
minItems: 1
maxItems: 20
MarketplaceId_2:
description: A marketplace identifier. Specifies the marketplace for which prices are returned.
type: string
DetailedShippingTimeType:
type: object
properties:
minimumHours:
type: integer
format: int64
description: The minimum time, in hours, that the item will likely be shipped after the order has been placed.
maximumHours:
type: integer
format: int64
description: The maximum time, in hours, that the item will likely be shipped after the order has been placed.
availableDate:
type: string
description: The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping.
availabilityType:
type: string
description: '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:
- NOW
- FUTURE_WITHOUT_DATE
- FUTURE_WITH_DATE
x-docgen-enum-table-extension:
- value: NOW
description: The item is available for shipping now.
- value: FUTURE_WITHOUT_DATE
description: The item will be available for shipping on an unknown date in the future.
- value: FUTURE_WITH_DATE
description: The item will be available for shipping on a known date in the future.
description: The time range in which an item will likely be shipped once an order has been placed.
CompetitivePricingType:
type: object
required:
- CompetitivePrices
- NumberOfOfferListings
properties:
CompetitivePrices:
$ref: '#/components/schemas/CompetitivePriceList'
NumberOfOfferListings:
$ref: '#/components/schemas/NumberOfOfferListingsList'
TradeInValue:
description: The trade-in value of the item in the trade-in program.
$ref: '#/components/schemas/MoneyType_2'
description: Competitive pricing information for the item.
x-refined-from:
- amazon-seller-central-product-pricing-2022-05-01-original.json
- amazon-seller-central-product-pricing-v0-original.json