A+ Content Management API reference

Add rich marketing content to Amazon product detail pages.

Selling Partner API for A+ Content Management

Overview

With the A+ Content API, you can build applications that help selling partners add rich marketing content to their Amazon product detail pages. A+ content helps selling partners share their brand and product story, which helps buyers make informed purchasing decisions. Selling partners assemble content by choosing from content modules and adding images and text.

Version information

Version : 2020-11-01

Contact information

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

License information

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

URI scheme

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

Consumes

  • application/json

Produces

  • application/json

Operations

searchContentDocuments
createContentDocument
getContentDocument
updateContentDocument
listContentDocumentAsinRelations
postContentDocumentAsinRelations
validateContentDocumentAsinRelations
searchContentPublishRecords
postContentDocumentApprovalSubmission
postContentDocumentSuspendSubmission

Paths

GET /aplus/2020-11-01/contentDocuments

Operation: searchContentDocuments

Description

Returns a list of all A+ Content documents assigned to a selling partner. This operation returns only the metadata of the A+ Content documents. Call the getContentDocument operation to get the actual contents of the A+ Content documents.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
QuerypageToken
optional
A page token from the nextPageToken response element returned by your previous call to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
minLength : 1
string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
SearchContentDocumentsResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentDocuments

Operation: createContentDocument

Description

Creates a new A+ Content document.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
BodypostContentDocumentRequest
required
The content document request details.PostContentDocumentRequest

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
PostContentDocumentResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

GET /aplus/2020-11-01/contentDocuments/{contentReferenceKey}

Operation: getContentDocument

Description

Returns an A+ Content document, if available.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
QueryincludedDataSet
required
The set of A+ Content data types to include in the response.
Min count : 1
< enum (IncludedDataSet) > array(csv)

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
GetContentDocumentResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey}

Operation: updateContentDocument

Description

Updates an existing A+ Content document.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
BodypostContentDocumentRequest
required
The content document request details.PostContentDocumentRequest

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
PostContentDocumentResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

GET /aplus/2020-11-01/contentDocuments/{contentReferenceKey}/asins

Operation: listContentDocumentAsinRelations

Description

Returns a list of ASINs related to the specified A+ Content document, if available. If you do not include the asinSet parameter, the operation returns all ASINs related to the content document.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ Content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
QueryincludedDataSet
optional
The set of A+ Content data types to include in the response. If you do not include this parameter, the operation returns the related ASINs without metadata.
Min count : 0
< enum (IncludedDataSet) > array(csv)
QueryasinSet
optional
The set of ASINs.
< string > array(csv)
QuerypageToken
optional
A page token from the nextPageToken response element returned by your previous call to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
minLength : 1
string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ListContentDocumentAsinRelationsResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey}/asins

Operation: postContentDocumentAsinRelations

Description

Replaces all ASINs related to the specified A+ Content document, if available. This may add or remove ASINs, depending on the current set of related ASINs. Removing an ASIN has the side effect of suspending the content document from that ASIN.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
BodypostContentDocumentAsinRelationsRequest
required
The content document ASIN relations request details.PostContentDocumentAsinRelationsRequest

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
PostContentDocumentAsinRelationsResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentAsinValidations

Operation: validateContentDocumentAsinRelations

Description

Checks if the A+ Content document is valid for use on a set of ASINs.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
QueryasinSet
optional
The set of ASINs.
< string > array(csv)
BodypostContentDocumentRequest
required
The content document request details.PostContentDocumentRequest

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
ValidateContentDocumentAsinRelationsResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

GET /aplus/2020-11-01/contentPublishRecords

Operation: searchContentPublishRecords

Description

Searches for A+ Content publishing records, if available.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string
Queryasin
required
The Amazon Standard Identification Number (ASIN).
minLength : 10
string
QuerypageToken
optional
A page token from the nextPageToken response element returned by your previous call to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any other parameter will cause the request to fail. When no nextPageToken value is returned there are no more pages to return. A pageToken value is not usable across different operations.
minLength : 1
string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
SearchContentPublishRecordsResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey}/approvalSubmissions

Operation: postContentDocumentApprovalSubmission

Description

Submits an A+ Content document for review, approval, and publishing.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
PostContentDocumentApprovalSubmissionResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

POST /aplus/2020-11-01/contentDocuments/{contentReferenceKey}/suspendSubmissions

Operation: postContentDocumentSuspendSubmission

Description

Submits a request to suspend visible A+ Content. This neither deletes the content document nor the ASIN relations.

Usage Plans:

Plan typeRate (requests per second)Burst
Default1010
Selling partner specificVariableVariable

The x-amzn-RateLimit-Limit response header returns the usage plan rate limits that were applied to the requested operation. Rate limits for some selling partners will vary from the default rate and burst shown in the table above. For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.

Parameters

TypeNameDescriptionSchema
PathcontentReferenceKey
required
The unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.
minLength : 1
string
QuerymarketplaceId
required
The identifier for the marketplace where the A+ Content is published.
minLength : 1
string

Responses

HTTP CodeDescriptionSchema
200Success.
Headers :
x-amzn-RateLimit-Limit (string) : Your rate limit (requests per second) for this operation.
x-amzn-RequestId (string) : Unique request reference identifier.
PostContentDocumentSuspendSubmissionResponse

For error status codes, descriptions and schemas, see Error responses and schemas.

Error Responses and Schemas

This table contains HTTP status codes and associated information for error responses.

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

Definitions

AplusResponse

The base response data for all A+ Content operations when a request is successful or partially successful. Individual operations may extend this with additional data.

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet

AplusPaginatedResponse

The base response data for paginated A+ Content operations. Individual operations may extend this with additional data. If nextPageToken is not returned, there are no more pages to return.

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
nextPageToken
optional
A page token that is returned when the results of the call exceed the page size. To get another page of results, call the operation again, passing in this value with the pageToken parameter.PageToken

ErrorList

The error response for when a request is unsuccessful.

NameDescriptionSchema
errors
required
A list of error responses returned when a request is unsuccessful.< Error > array

MessageSet

A set of messages to the user, such as warnings or comments.

Type : < Error > array

Unique items : true

Error

Error response returned when the request is unsuccessful.

NameDescriptionSchema
code
required
The code that identifies the type of error condition.
minLength : 1
string
message
required
A human readable description of the error condition.
minLength : 1
string
details
optional
Additional information, if available, to clarify the error condition.
minLength : 1
string

ContentMetadataRecordList

A list of A+ Content metadata records.

Type : < ContentMetadataRecord > array

Unique items : false

ContentMetadataRecord

The metadata for an A+ Content document, with additional information for content management.

NameDescriptionSchema
contentReferenceKey
required
A unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.ContentReferenceKey
contentMetadata
required
The metadata of an A+ Content document.ContentMetadata

ContentMetadata

The metadata of an A+ Content document.

NameDescriptionSchema
name
required
The A+ Content document name.
minLength : 1
maxLength : 100
string
marketplaceId
required
The identifier for the marketplace where the A+ Content is published.MarketplaceId
status
required
The submission status of the content document.ContentStatus
badgeSet
required
The set of content badges.ContentBadgeSet
updateTime
required
The approximate age of the A+ Content document and metadata.string (date-time)

ContentType

The A+ Content document type.

Type : enum

ValueDescription
EBCA+ Content published through the A+ Content Manager in Seller Central.
EMCA+ Content published through the A+ Content Manager in Vendor Central.

ContentSubType

The A+ Content document subtype. This represents a special-purpose type of an A+ Content document. Not every A+ Content document type will have a subtype, and subtypes may change at any time.

Type : string

minLength : 1

ContentStatus

The submission status of the content document.

Type : enum

ValueDescription
APPROVEDThe content is approved and will be published to applied ASINs.
DRAFTThe content has not yet been submitted for approval.
REJECTEDThe content has been rejected in moderation and needs to be revised and resubmitted based on the rejection reasons provided.
SUBMITTEDThe content has been submitted for approval and is currently waiting for moderation.

ContentBadgeSet

The set of content badges.

Type : < ContentBadge > array

Unique items : true

ContentBadge

A flag that provides additional information about an A+ Content document.

Type : enum

ValueDescription
BULKThis content is applied to ASINs in bulk.
GENERATEDThis content is generated by an automated process. If any user modifies this content, it will lose the GENERATED badge.
LAUNCHPADLaunchpad content.
PREMIUMPremium content
STANDARDStandard content.

AsinBadgeSet

The set of ASIN badges.

Type : < AsinBadge > array

Unique items : true

AsinBadge

A flag that provides additional information about an ASIN. This is contextual and may change depending on the request that generated it.

Type : enum

ValueDescription
BRAND_NOT_ELIGIBLEThis ASIN is not part of the current user's brand. If the current user corrects their brand registration to include this ASIN, it will lose the BrandNotEligible badge.
CATALOG_NOT_FOUNDThis ASIN was not found in the Amazon catalog. If any user creates or restores this ASIN, it will lose the CatalogNotFound badge.
CONTENT_NOT_PUBLISHEDThis ASIN does not have the specified A+ Content published to it. If the current user publishes the specified content for this ASIN, it will lose the ContentNotPublished badge.
CONTENT_PUBLISHEDThis ASIN has the specified A+ Content published to it. If the current user suspends the specified content for this ASIN, it will lose the ContentPublished badge.

MarketplaceId

The identifier for the marketplace where the A+ Content is published.

Type : string

minLength : 1

LanguageTag

The IETF language tag. This only supports the primary language subtag with one secondary language subtag. The secondary language subtag is almost always a regional designation. This does not support additional subtags beyond the primary and secondary subtags.
Pattern: ^[a-z]{2,}-[A-Z0-9]{2,}$

Type : string

minLength : 5

AsinSet

The set of ASINs.

Type : < Asin > array

Unique items : true

Asin

The Amazon Standard Identification Number (ASIN).

Type : string

minLength : 10

AsinMetadataSet

The set of ASIN metadata.

Type : < AsinMetadata > array

Unique items : true

AsinMetadata

The A+ Content ASIN with additional metadata for content management. If you don't include the includedDataSet parameter in a call to the listContentDocumentAsinRelations operation, the related ASINs are returned without metadata.

NameDescriptionSchema
asin
required
The Amazon Standard Identification Number (ASIN).Asin
badgeSet
optional
The set of ASIN badges.AsinBadgeSet
parent
optional
The Amazon Standard Identification Number (ASIN).Asin
title
optional
The title for the ASIN in the Amazon catalog.
minLength : 1
string
imageUrl
optional
The default image for the ASIN in the Amazon catalog.
minLength : 1
string
contentReferenceKeySet
optional
A set of content reference keys.ContentReferenceKeySet

PublishRecordList

A list of A+ Content publishing records.

Type : < PublishRecord > array

Unique items : false

PublishRecord

The full context for an A+ Content publishing event.

NameDescriptionSchema
marketplaceId
required
The identifier for the marketplace where the A+ Content is published.MarketplaceId
locale
required
The IETF language tag. This only supports the primary language subtag with one secondary language subtag. The secondary language subtag is almost always a regional designation. This does not support additional subtags beyond the primary and secondary subtags.
Pattern: ^[a-z]{2,}-[A-Z0-9]{2,}$
LanguageTag
asin
required
The Amazon Standard Identification Number (ASIN).Asin
contentType
required
The A+ Content document type.ContentType
contentSubType
optional
The A+ Content document subtype. This represents a special-purpose type of an A+ Content document. Not every A+ Content document type will have a subtype, and subtypes may change at any time.ContentSubType
contentReferenceKey
required
A unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.ContentReferenceKey

ContentReferenceKeySet

A set of content reference keys.

Type : < ContentReferenceKey > array

Unique items : true

ContentReferenceKey

A unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.

Type : string

minLength : 1

PageToken

A page token that is returned when the results of the call exceed the page size. To get another page of results, call the operation again, passing in this value with the pageToken parameter.

Type : string

minLength : 1

ImageCropSpecification

The instructions for optionally cropping an image. If no cropping is desired, set the dimensions to the original image size. If the image is cropped and no offset values are provided, then the coordinates of the top left corner of the cropped image, relative to the original image, are defaulted to (0,0).

NameDescriptionSchema
size
required
The dimensions extending from the top left corner of the cropped image, or the top left corner of the original image if there is no cropping. Only pixels is allowed as the units value for ImageDimensions.ImageDimensions
offset
optional
The top left corner of the cropped image, specified in the original image's coordinate space.ImageOffsets

ImageDimensions

The dimensions extending from the top left corner of the cropped image, or the top left corner of the original image if there is no cropping. Only pixels is allowed as the units value for ImageDimensions.

NameDescriptionSchema
width
required
A whole number dimension and its unit of measurement. For example, this can represent 100 pixels.IntegerWithUnits
height
required
A whole number dimension and its unit of measurement. For example, this can represent 100 pixels.IntegerWithUnits

ImageOffsets

The top left corner of the cropped image, specified in the original image's coordinate space.

NameDescriptionSchema
x
required
A whole number dimension and its unit of measurement. For example, this can represent 100 pixels.IntegerWithUnits
y
required
A whole number dimension and its unit of measurement. For example, this can represent 100 pixels.IntegerWithUnits

IntegerWithUnits

A whole number dimension and its unit of measurement. For example, this can represent 100 pixels.

NameDescriptionSchema
value
required
The dimension value.integer
units
required
The unit of measurement.string

ContentRecord

A content document with additional information for content management.

NameDescriptionSchema
contentReferenceKey
required
A unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.ContentReferenceKey
contentMetadata
optional
The metadata of an A+ Content document.ContentMetadata
contentDocument
optional
The A+ Content document. This is the enhanced content that is published to product detail pages.ContentDocument

ContentDocument

The A+ Content document. This is the enhanced content that is published to product detail pages.

NameDescriptionSchema
name
required
The A+ Content document name.
minLength : 1
maxLength : 100
string
contentType
required
The A+ Content document type.ContentType
contentSubType
optional
The A+ Content document subtype. This represents a special-purpose type of an A+ Content document. Not every A+ Content document type will have a subtype, and subtypes may change at any time.ContentSubType
locale
required
The IETF language tag. This only supports the primary language subtag with one secondary language subtag. The secondary language subtag is almost always a regional designation. This does not support additional subtags beyond the primary and secondary subtags.
Pattern: ^[a-z]{2,}-[A-Z0-9]{2,}$
LanguageTag
contentModuleList
required
A list of A+ Content modules.ContentModuleList

ContentModuleList

A list of A+ Content modules.

Type : < ContentModule > array

Min items : 1
Max items : 100
Unique items : false

ContentModule

An A+ Content module. An A+ Content document is composed of content modules. The contentModuleType property selects which content module types to use.

NameDescriptionSchema
contentModuleType
required
The type of A+ Content module.ContentModuleType
standardCompanyLogo
optional
The standard company logo image.StandardCompanyLogoModule
standardComparisonTable
optional
The standard product comparison table.StandardComparisonTableModule
standardFourImageText
optional
Four standard images with text, presented across a single row.StandardFourImageTextModule
standardFourImageTextQuadrant
optional
Four standard images with text, presented on a grid of four quadrants.StandardFourImageTextQuadrantModule
standardHeaderImageText
optional
Standard headline text, an image, and body text.StandardHeaderImageTextModule
standardImageSidebar
optional
Two images, two paragraphs, and two bulleted lists. One image is smaller and displayed in the sidebar.StandardImageSidebarModule
standardImageTextOverlay
optional
A standard background image with a floating text box.StandardImageTextOverlayModule
standardMultipleImageText
optional
Standard images with text, presented one at a time. The user clicks on thumbnails to view each block.StandardMultipleImageTextModule
standardProductDescription
optional
Standard product description text.StandardProductDescriptionModule
standardSingleImageHighlights
optional
A standard image with several paragraphs and a bulleted list.StandardSingleImageHighlightsModule
standardSingleImageSpecsDetail
optional
A standard image with paragraphs and a bulleted list, and extra space for technical details.StandardSingleImageSpecsDetailModule
standardSingleSideImage
optional
A standard headline and body text with an image on the side.StandardSingleSideImageModule
standardTechSpecs
optional
The standard table of technical feature names and definitions.StandardTechSpecsModule
standardText
optional
A standard headline and body text.StandardTextModule
standardThreeImageText
optional
Three standard images with text, presented across a single row.StandardThreeImageTextModule

ContentModuleType

The type of A+ Content module.

Type : enum

ValueDescription
STANDARD_COMPANY_LOGOThe standard company logo image.
STANDARD_COMPARISON_TABLEThe standard product comparison table or chart.
STANDARD_FOUR_IMAGE_TEXTFour standard images with text, presented across a single row.
STANDARD_FOUR_IMAGE_TEXT_QUADRANTFour standard images with text, presented on a grid of four quadrants.
STANDARD_HEADER_IMAGE_TEXTStandard headline text, an image, and body text.
STANDARD_IMAGE_SIDEBARTwo images, two paragraphs, and two bulleted lists. One image is smaller and is displayed in the sidebar.
STANDARD_IMAGE_TEXT_OVERLAYA standard background image with a floating text box.
STANDARD_MULTIPLE_IMAGE_TEXTStandard images with text, presented one at a time. The user clicks on thumbnails to view each block.
STANDARD_PRODUCT_DESCRIPTIONStandard product description text.
STANDARD_SINGLE_IMAGE_HIGHLIGHTSA standard image with several paragraphs and a bulleted list.
STANDARD_SINGLE_IMAGE_SPECS_DETAILA standard image with paragraphs and a bulleted list, and extra space for technical details.
STANDARD_SINGLE_SIDE_IMAGEA standard headline and body text with an image on the side.
STANDARD_TECH_SPECSThe standard table of technical feature names and definitions.
STANDARD_TEXTStandard headline and body text.
STANDARD_THREE_IMAGE_TEXTThree standard images with text, presented across one row.

StandardCompanyLogoModule

The standard company logo image.

NameDescriptionSchema
companyLogo
required
A reference to an image, hosted in the A+ Content media library.ImageComponent

StandardComparisonTableModule

The standard product comparison table.

NameSchema
productColumns
optional
< StandardComparisonProductBlock > array
metricRowLabels
optional
< PlainTextItem > array

StandardFourImageTextModule

Four standard images with text, presented across a single row.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
block1
optional
The A+ Content standard image and text box block.StandardImageTextBlock
block2
optional
The A+ Content standard image and text box block.StandardImageTextBlock
block3
optional
The A+ Content standard image and text box block.StandardImageTextBlock
block4
optional
The A+ Content standard image and text box block.StandardImageTextBlock

StandardFourImageTextQuadrantModule

Four standard images with text, presented on a grid of four quadrants.

NameDescriptionSchema
block1
required
The A+ Content standard image and text box block.StandardImageTextBlock
block2
required
The A+ Content standard image and text box block.StandardImageTextBlock
block3
required
The A+ Content standard image and text box block.StandardImageTextBlock
block4
required
The A+ Content standard image and text box block.StandardImageTextBlock

StandardHeaderImageTextModule

Standard headline text, an image, and body text.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
block
optional
The A+ Content standard image and text box block.StandardImageTextBlock

StandardImageSidebarModule

Two images, two paragraphs, and two bulleted lists. One image is smaller and displayed in the sidebar.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
imageCaptionBlock
optional
The A+ Content standard image and caption block.StandardImageCaptionBlock
descriptionTextBlock
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
descriptionListBlock
optional
The A+ Content standard fixed length list of text, usually presented as bullet points.StandardTextListBlock
sidebarImageTextBlock
optional
The A+ Content standard image and text box block.StandardImageTextBlock
sidebarListBlock
optional
The A+ Content standard fixed length list of text, usually presented as bullet points.StandardTextListBlock

StandardImageTextOverlayModule

A standard background image with a floating text box.

NameDescriptionSchema
overlayColorType
required
The relative color scheme of content.ColorType
block
optional
The A+ Content standard image and text box block.StandardImageTextBlock

StandardMultipleImageTextModule

Standard images with text, presented one at a time. The user clicks on thumbnails to view each block.

NameSchema
blocks
optional
< StandardImageTextCaptionBlock > array

StandardProductDescriptionModule

Standard product description text.

NameDescriptionSchema
body
required
A list of rich text content, usually presented in a text box.ParagraphComponent

StandardSingleImageHighlightsModule

A standard image with several paragraphs and a bulleted list.

NameDescriptionSchema
image
optional
A reference to an image, hosted in the A+ Content media library.ImageComponent
headline
optional
Rich text content.TextComponent
textBlock1
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
textBlock2
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
textBlock3
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
bulletedListBlock
optional
The A+ standard fixed-length list of text, with a related headline.StandardHeaderTextListBlock

StandardSingleImageSpecsDetailModule

A standard image with paragraphs and a bulleted list, and extra space for technical details.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
image
optional
A reference to an image, hosted in the A+ Content media library.ImageComponent
descriptionHeadline
optional
Rich text content.TextComponent
descriptionBlock1
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
descriptionBlock2
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock
specificationHeadline
optional
Rich text content.TextComponent
specificationListBlock
optional
The A+ standard fixed-length list of text, with a related headline.StandardHeaderTextListBlock
specificationTextBlock
optional
The A+ Content standard text box block, comprised of a paragraph with a headline.StandardTextBlock

StandardSingleSideImageModule

A standard headline and body text with an image on the side.

NameDescriptionSchema
imagePositionType
required
The relative positioning of content.PositionType
block
optional
The A+ Content standard image and text box block.StandardImageTextBlock

StandardTechSpecsModule

The standard table of technical feature names and definitions.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
specificationList
required
The specification list.< StandardTextPairBlock > array
tableCount
optional
The number of tables to present. Features are evenly divided between the tables.
Minimum value : 1
Maximum value : 2
integer

StandardTextModule

A standard headline and body text.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
body
required
A list of rich text content, usually presented in a text box.ParagraphComponent

StandardThreeImageTextModule

Three standard images with text, presented across a single row.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
block1
optional
The A+ Content standard image and text box block.StandardImageTextBlock
block2
optional
The A+ Content standard image and text box block.StandardImageTextBlock
block3
optional
The A+ Content standard image and text box block.StandardImageTextBlock

StandardComparisonProductBlock

The A+ Content standard comparison product block.

NameDescriptionSchema
position
required
The rank or index of this comparison product block within the module. Different blocks cannot occupy the same position within a single module.
Minimum value : 1
Maximum value : 6
integer
image
optional
A reference to an image, hosted in the A+ Content media library.ImageComponent
title
optional
The comparison product title.
minLength : 1
maxLength : 80
string
asin
optional
The Amazon Standard Identification Number (ASIN).Asin
highlight
optional
Determines whether this block of content is visually highlighted.boolean
metrics
optional
Comparison metrics for the product.< PlainTextItem > array

StandardHeaderTextListBlock

The A+ standard fixed-length list of text, with a related headline.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
block
optional
The A+ Content standard fixed length list of text, usually presented as bullet points.StandardTextListBlock

StandardTextListBlock

The A+ Content standard fixed length list of text, usually presented as bullet points.

NameSchema
textList
required
< TextItem > array

StandardImageTextCaptionBlock

The A+ Content standard image and text block, with a related caption. The caption may not display on all devices.

NameDescriptionSchema
block
optional
The A+ Content standard image and text box block.StandardImageTextBlock
caption
optional
Rich text content.TextComponent

StandardImageCaptionBlock

The A+ Content standard image and caption block.

NameDescriptionSchema
image
optional
A reference to an image, hosted in the A+ Content media library.ImageComponent
caption
optional
Rich text content.TextComponent

StandardImageTextBlock

The A+ Content standard image and text box block.

NameDescriptionSchema
image
optional
A reference to an image, hosted in the A+ Content media library.ImageComponent
headline
optional
Rich text content.TextComponent
body
optional
A list of rich text content, usually presented in a text box.ParagraphComponent

StandardTextBlock

The A+ Content standard text box block, comprised of a paragraph with a headline.

NameDescriptionSchema
headline
optional
Rich text content.TextComponent
body
optional
A list of rich text content, usually presented in a text box.ParagraphComponent

StandardTextPairBlock

The A+ Content standard label and description block, comprised of a pair of text components.

NameDescriptionSchema
label
optional
Rich text content.TextComponent
description
optional
Rich text content.TextComponent

TextItem

Rich positional text, usually presented as a collection of bullet points.

NameDescriptionSchema
position
required
The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
Minimum value : 1
Maximum value : 100
integer
text
required
Rich text content.TextComponent

PlainTextItem

Plain positional text, used in collections of brief labels and descriptors.

NameDescriptionSchema
position
required
The rank or index of this text item within the collection. Different items cannot occupy the same position within a single collection.
Minimum value : 1
Maximum value : 100
integer
value
required
The actual plain text.
minLength : 1
maxLength : 250
string

ImageComponent

A reference to an image, hosted in the A+ Content media library.

NameDescriptionSchema
uploadDestinationId
required
This identifier is provided by the Selling Partner API for Uploads.
minLength : 1
string
imageCropSpecification
required
The instructions for optionally cropping an image. If no cropping is desired, set the dimensions to the original image size. If the image is cropped and no offset values are provided, then the coordinates of the top left corner of the cropped image, relative to the original image, are defaulted to (0,0).ImageCropSpecification
altText
required
The alternative text for the image.
minLength : 1
maxLength : 100
string

ParagraphComponent

A list of rich text content, usually presented in a text box.

NameSchema
textList
required
< TextComponent > array

TextComponent

Rich text content.

NameDescriptionSchema
value
required
The actual plain text.
minLength : 1
maxLength : 10000
string
decoratorSet
optional
A set of content decorators.DecoratorSet

ColorType

The relative color scheme of content.

Type : enum

ValueDescription
DARKDark grey, semi-opaque shaded background for light text overlay box.
LIGHTWhite, semi-opaque shaded background for dark text overlay box.

PositionType

The relative positioning of content.

Type : enum

ValueDescription
LEFTIndicates that the content is to be positioned on the left side of the module.
RIGHTIndicates that the content is to be positioned on the right side of the module.

DecoratorSet

A set of content decorators.

Type : < Decorator > array

Unique items : true

Decorator

A decorator applied to a content string value in order to create rich text.

NameDescriptionSchema
type
optional
The type of rich text decorator.DecoratorType
offset
optional
The starting character of this decorator within the content string. Use zero for the first character.
Minimum value : 0
Maximum value : 10000
integer
length
optional
The number of content characters to alter with this decorator. Decorators such as line breaks can have zero length and fit between characters.
Minimum value : 0
Maximum value : 10000
integer
depth
optional
The relative intensity or variation of this decorator. Decorators such as bullet-points, for example, can have multiple indentation depths.
Minimum value : 0
Maximum value : 100
integer

DecoratorType

The type of rich text decorator.

Type : enum

ValueDescription
LIST_ITEMFormatted list item, used in either numbered or bulleted lists, inside the list enclosure.
LIST_ORDEREDNumbered list enclosure.
LIST_UNORDEREDBulleted list enclosure.
STYLE_BOLDBold text formatting.
STYLE_ITALICItalic text formatting.
STYLE_LINEBREAKNew line of text.
STYLE_PARAGRAPHParagraph text formatting.
STYLE_UNDERLINEUnderline text formatting.

SearchContentDocumentsResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
nextPageToken
optional
A page token that is returned when the results of the call exceed the page size. To get another page of results, call the operation again, passing in this value with the pageToken parameter.PageToken
contentMetadataRecords
required
The content metadata records.ContentMetadataRecordList

GetContentDocumentResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
contentRecord
required
A content document with additional information for content management.ContentRecord

PostContentDocumentRequest

NameDescriptionSchema
contentDocument
required
The A+ Content document. This is the enhanced content that is published to product detail pages.ContentDocument

PostContentDocumentResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
contentReferenceKey
required
A unique reference key for the A+ Content document. A content reference key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match any A+ content identifier.ContentReferenceKey

ListContentDocumentAsinRelationsResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
nextPageToken
optional
A page token that is returned when the results of the call exceed the page size. To get another page of results, call the operation again, passing in this value with the pageToken parameter.PageToken
asinMetadataSet
required
The set of ASIN metadata.AsinMetadataSet

PostContentDocumentAsinRelationsRequest

NameDescriptionSchema
asinSet
required
The set of ASINs.AsinSet

PostContentDocumentAsinRelationsResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet

ValidateContentDocumentAsinRelationsResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
errors
required
A list of error responses returned when a request is unsuccessful.< Error > array

SearchContentPublishRecordsResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet
nextPageToken
optional
A page token that is returned when the results of the call exceed the page size. To get another page of results, call the operation again, passing in this value with the pageToken parameter.PageToken
publishRecordList
required
A list of A+ Content publishing records.PublishRecordList

PostContentDocumentApprovalSubmissionResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet

PostContentDocumentSuspendSubmissionResponse

Polymorphism : Composition

NameDescriptionSchema
warnings
optional
A set of messages to the user, such as warnings or comments.MessageSet

IncludedDataSet

Type : enum

For use with the operation(s): getContentDocument

ValueDescription
CONTENTSThe contents of the content document.
METADATAThe metadata of the content document.

For use with the operation(s): listContentDocumentAsinRelations

ValueDescription
METADATAThe metadata of the content document.