putListingsItem

put

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerId}/{sku}

Creates a new or fully-updates an existing listings item for a selling partner.

Usage Plan:

Rate (requests per second)	Burst
5	10

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation, when available. The preceding table indicates the default rate and burst values for this operation. Selling partners whose business demands require higher throughput can 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 documentation.

Path Params

sellerId

string

required

A selling partner identifier, such as a merchant account or vendor code.

sku

string

required

A selling partner provided identifier for an Amazon listing.

Query Params

marketplaceIds

array of strings

required

length ≤ 1

A comma-delimited list of Amazon marketplace identifiers for the request.

marketplaceIds*

includedData

array of strings

Defaults to issues

A comma-delimited list of data sets to include in the response. Default: issues.

Show Details

identifiers	Identifiers associated with the item in the Amazon catalog, such as Amazon Standard Identification Number (ASIN). Can only be requested when `mode` is `VALIDATION_PREVIEW`.
issues	The issues associated with the listing item.

includedData

mode

string

enum

The mode of operation for the request.

Allowed:

issueLocale

string

A locale for localization of issues. When not provided, the default language code of the first marketplace is used. Examples: en_US, fr_CA, fr_FR. Localized messages default to en_US when a localization is not available in the specified locale.

Body Params

The request body schema for the putListingsItem operation.

productType

string

required

The Amazon product type of the listings item.

requirements

string

enum

The name of the requirements set for the provided data.

Show Details

LISTING	Indicates the submitted data contains product facts and sales terms.
LISTING_PRODUCT_ONLY	Indicates the submitted data contains product facts only.
LISTING_OFFER_ONLY	Indicates the submitted data contains sales terms only. Not supported for vendors (vendors will receive an HTTP status code 400 response).

Allowed:

attributes

object

required

A JSON object containing structured listings item attribute data keyed by attribute name.

Responses

Language

Response

Choose an example:

application/json

200Successfully understood the request to create or fully-update a listings item. See the response to determine if the submission has been accepted.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.