"description":"The Selling Partner API for Pricing helps you programmatically retrieve product pricing and offer pricing information for Amazon Marketplace products.\n\nFor more information, refer to the [Product Pricing v2022-05-01 Use Case Guide](https://developer-docs.amazon.com/sp-api/docs/product-pricing-api-v2022-05-01-use-case-guide).",
"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 may change, and different offers may be featured based on other factors, including fulfillment capabilities to a specific customer. The response to an unsuccessful request includes the available error text.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.033 | 1 |\n\nThe `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, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"Returns the competitive summary response including featured buying options for the ASIN and `marketplaceId` combination.\n\n**Usage Plan:**\n\n| Rate (requests per second) | Burst |\n| ---- | ---- |\n| 0.033 | 1 |\n\nThe `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, refer to [Usage Plans and Rate Limits in the Selling Partner API](https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api).",
"description":"Indicates access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.",
"description":"The list of `lowestPricedOffersInput` parameters used to build the `lowestPricedOffers` in the response. This attribute is valid only if `lowestPricedOffers` is requested in `includedData`.",
"description":"The URI associated with the individual APIs being called as part of the batch request. For `getCompetitiveSummary`, this should be `/products/pricing/2022-05-01/items/competitiveSummary`.",
"$ref":"#/definitions/HttpUri"
}
}
},
"CompetitiveSummaryIncludedData":{
"type":"string",
"description":"The supported types of data in the `getCompetitiveSummary` API.",
"description":"The input required for building the `LowestPricedOffers` data in the response.",
"type":"object",
"required":[
"itemCondition",
"offerType"
],
"properties":{
"itemCondition":{
"type":"string",
"description":"The condition of the item offer that was requested for the `LowestPricedOffers`. The default `itemCondition` is `New`.",
"$ref":"#/definitions/Condition"
},
"offerType":{
"type":"string",
"description":"The type of offers requested for the `LowestPricedOffers`. The `offerType` options are `Consumer` or `Business`. The default `offerType` is `Consumer`.",
"description":"The response list of the `competitiveSummaryBatch` operation.",
"type":"array",
"items":{
"description":"The response for the individual `competitiveSummary` request in the batch operation.",
"$ref":"#/definitions/CompetitiveSummaryResponse"
},
"minItems":1,
"maxItems":20
},
"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":"#/definitions/HttpStatusLine"
},
"body":{
"description":"The `competitiveSummaryResponse` body for a requested ASIN and `marketplaceId`.",
"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 of the featured offer. This field represents the buying options that a customer sees on the detail page. For example, B2B, Fresh, and Subscribe n Save. Currently supports `NEW`",
"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":"#/definitions/SegmentedFeaturedOffer"
},
"minItems":1
}
}
},
"SegmentedFeaturedOffer":{
"description":"A product offer with segment information indicating where it's featured.",
"allOf":[
{
"$ref":"#/definitions/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.",
"description":"The lowest priced offer for the requested item condition and offer type.",
"type":"object",
"required":[
"lowestPricedOffersInput",
"offers"
],
"properties":{
"lowestPricedOffersInput":{
"description":"The filtering criteria used to retrieve this lowest-priced offers correspond to the `lowestPricedOffersInputs` received in the request.",
"type":"object",
"$ref":"#/definitions/LowestPricedOffersInput"
},
"offers":{
"description":"A list of up to 20 lowest priced offers that match the criteria specified in the `lowestPricedOffersInput` parameter.",
"description":"The fulfillment type for the offer. Possible values are AFN (Amazon Fulfillment Network) and MFN (Merchant Fulfillment Network)."
},
"listingPrice":{
"description":"Offer buying price. Does not include shipping, points, or applicable promotions.",
"$ref":"#/definitions/MoneyType"
},
"shippingOptions":{
"description":"A list of shipping options associated with this offer",
"type":"array",
"items":{
"$ref":"#/definitions/ShippingOption"
}
},
"points":{
"description":"The number of Amazon Points offered with the purchase of an item, and their monetary value. Note that the Points element is only returned in Japan (JP).",
"description":"The shipping option available for the offer.",
"type":"object",
"required":[
"shippingOptionType",
"price"
],
"properties":{
"shippingOptionType":{
"description":"The type of the 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":"#/definitions/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 make up this segment",
"type":"string",
"enum":[
"PRIME",
"NON_PRIME"
],
"x-docgen-enum-table-extension":[
{
"value":"PRIME",
"description":"PRIME"
},
{
"value":"NON_PRIME",
"description":"NON_PRIME"
}
]
},
"segmentDetails":{
"description":"The details about the segment.",
"$ref":"#/definitions/SegmentDetails"
}
}
},
"SegmentDetails":{
"description":"The details about the segment.",
"type":"object",
"properties":{
"glanceViewWeightPercentage":{
"description":"Glance view weight percentage for this segment. The glance views for this segment as a percentage of total glance views across all segments on the ASIN. A higher percentage indicates more Amazon customers see this offer as the Featured Offer.",
"description":"The status of the featured offer expected price computation. Possible values include `VALID_FOEP`, `NO_COMPETING_OFFER`, `OFFER_NOT_ELIGIBLE`, `OFFER_NOT_FOUND`, `ASIN_NOT_ELIGIBLE`. Additional values may be added in the future.",
"description":"The offer that will likely be the featured offer if the target offer is priced above its featured offer expected price. If the target offer is currently the featured offer, this property will be different than `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`.",
"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":"#/definitions/MoneyType"
},
"points":{
"description":"The number of Amazon Points offered with the purchase of an item, and their monetary value.",
"$ref":"#/definitions/Points"
}
}
},
"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 will be omitted.",
"$ref":"#/definitions/OfferIdentifier"
},
"condition":{
"description":"The item condition.",
"$ref":"#/definitions/Condition"
},
"price":{
"description":"The current active price of the offer.",
"description":"A mapping of additional HTTP headers to send/receive for an individual request within a batch.",
"type":"object",
"additionalProperties":{
"type":"string"
}
},
"HttpStatusLine":{
"description":"The HTTP status line associated with the response to an individual request within a batch. 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"
}
}
},
"HttpBody":{
"description":"Additional HTTP body information associated with an individual request within a batch.",
"description":"The URI associated with an individual request within a batch. For `FeaturedOfferExpectedPrice`, this should be `/products/pricing/2022-05-01/offer/featuredOfferExpectedPrice`.",
"description":"The common properties for responses to individual requests within a batch.",
"type":"object",
"required":[
"status",
"headers"
],
"properties":{
"headers":{
"$ref":"#/definitions/HttpHeaders"
},
"status":{
"$ref":"#/definitions/HttpStatusLine"
}
}
},
"OfferIdentifier":{
"description":"Identifies an offer from a particular seller on an ASIN.",
"type":"object",
"required":[
"marketplaceId",
"asin"
],
"properties":{
"marketplaceId":{
"$ref":"#/definitions/MarketplaceId",
"description":"A marketplace identifier."
},
"sellerId":{
"type":"string",
"description":"The seller identifier for the offer."
},
"sku":{
"type":"string",
"description":"The seller stock keeping unit (SKU) of the item. This will only be present for the target offer, which belongs to the requesting seller."
},
"asin":{
"$ref":"#/definitions/Asin",
"description":"The Amazon identifier for the item."
},
"fulfillmentType":{
"$ref":"#/definitions/FulfillmentType",
"description":"The fulfillment type for the offer."
}
}
},
"MoneyType":{
"type":"object",
"properties":{
"currencyCode":{
"type":"string",
"description":"The currency code in ISO 4217 format."