Product Advertising API
Developer Guide (API Version 2011-08-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

Error Messages

Product Advertising API returns error messages in English for the Amazon.com (US), Amazon.co.uk (UK), Amazon.de (DE), Amazon.fr (FR), and Amazon.ca (CA) locales. Error messages are in Japanese for the Amazon.co.jp (JP) locale.

Error Code & DescriptionMessageAffected Operations

AWS.ExactParameterRequirement

You will receive this message when the value of your parameter is longer than permitted by Product Advertising API.

Your request contains too much data for [ParameterName]. This parameter can have a maximum length of [MaximumNumber].All

AWS.ExceededMaximumParameterValues

You will receive this error message when you specify too many values for one or more parameters in your request.

Your request contains too many values for [ParameterName]. This parameter can have a maximum of [MaximumNumber] values.
  • ItemLookup

  • SimilarityLookup

AWS.InsufficientParameterValues

You will receive this error message when your request contains an insufficient number of values for a required parameter.

Your request contains too few values for [Parameter Name]. This parameter must have a minimum of [Minimum Value] values.All

AWS.InternalError

You will receive this error if Product Advertising API is unable to complete your request due to an internal problem or outage. For SOAP, this will be presented as a SOAP fault rather than an error.

We are unable to process your request at this time. Please retry your request. If you encounter this error repeatedly, please post a message on the AWS discussion board.All

AWS.InvalidAccount

You will receive this error when you try to use an AwsAccessKeyId in a locale where it is not registered for the Product Advertising API.

Your AccessKey Id is not registered for Product Advertising API. Please use the AccessKey Id obtained after registering at [RegistrationUrlForThatLocale] All

AWS.InvalidEnumeratedParameter

You will receive this error message when your request contains an invalid value for a parameter that has an explicit list of valid values, such as SearchIndex.

The value you specified for [ParameterName] is invalid. Valid values include [EnumeratedValuesList].
  • CartAdd

  • CartCreate

  • CartModify

  • ItemLookup

  • ItemSearch

  • SimilarityLookup

AWS.InvalidISO8601Time

You will receive this error when your request contains a date or time value that is not formatted according to the profile of the ISO-8601 date/time standard that is described at http://www.w3.org/TR/NOTE-datetime. For example, this error will be returned if your request contains an invalid value for the Version parameter.

[ParameterName]has an invalid value. It must contain a valid ISO 8601 date and time.All

AWS.InvalidOperationForMarketplace

You will receive this error message when you try to execute an operation in a locale where the operation is not supported.

This operation, [OperationName], is not available for this locale.All

AWS.InvalidOperationParameter

You will receive this error message when the operation name you entered is not available from Product Advertising API. For instance, if you tried to use AsinSearch (from AWS 3.0) as an operation name, you would get this error since AsinSearch is not a valid operation name in Product Advertising API 4.0.

The Operation parameter is invalid. Please modify the Operation parameter and retry. Valid values for the Operation parameter include [ListOfOperationValues].All

AWS.InvalidParameterCombination

You will receive this error message when two or more of the request parameters you have entered can not be used in the same request. For example, if you are using the CartAdd operation, you would receive this error if you tried to add items to the cart by both ASIN and OfferListingId.

Your request contains an invalid parameter combination. [ParameterName] and [ParameterName] cannot appear in the same request.
  • ItemSearch

  • CartCreate

  • CartAdd

AWS.InvalidParameterValue

You will receive this error message when your request contains an invalid value for an ID parameter, such as ItemId.

[ParameterValue] is not a valid value for [ParameterName]. Please change this value and retry your request.
  • CartAdd

  • CartCreate

  • CartModify

  • ItemLookup

  • ItemSearch

  • SimilarityLookup

AWS.InvalidResponseGroup

You will receive this error message when the response group name you entered in your request is incompatible with the operation you would like to perform.

Your ResponseGroup parameter is invalid. Valid response groups for [Operation Name] requests include [Available Response Group List].All

AWS.InvalidServiceParameter

You will receive this error message when the service name you provide in your request is not recognized or supported by Amazon. All Product Advertising API requests should use the service name "AWSECommerceService."

The Service parameter is invalid. Please modify the Service parameter and retry. Valid values for the Service parameter include [ValidServicesList].All

AWS.InvalidSubscriptionId

You will receive this error message when the subscription ID you use in your request is not recognized by AWS.

Your request contains an invalid subscription ID. Please retry your request with a valid subscription ID.All

AWS.MaximumParameterRequirement

You receive this error message when your request contains the wrong number of parameters from an exclusive group.

Your request should have at most [Maximum Number] of the following parameters: [Parameter Names].All

AWS.MinimumParameterRequirement

You receive this error message when your request contains the wrong number of parameters from an exclusive group.

Your request should have at least [Minimum Number] of the following parameters: [Parameter Names].All

AWS.MissingOperationParameter

You will receive this error message when your request does not include the Operation parameter and the name of the operation you would like to perform.

Your request is missing the Operation parameter. Please add the Operation parameter to your request and retry. Valid values for the Operation parameter include [ValidOperationsList].All

AWS.MissingParameterCombination

You will receive this error message when your request does not contain a combination of two or more parameters that must be present together in your request.

Your request is missing a required parameter combination. Required parameter combinations include [Parameter One].
  • ItemLookup

AWS.MissingParameters

You will receive this error when your request does not include all of the parameters required by the operation.

Your request is missing required parameters. Required parameters include [RequiredParameterList].All

AWS.MissingParameterValueCombination

You will receive this error message when your request requires a combination of parameters, one or more of which must have a specific value. For example, when you make an ItemLookup request for a product based on its Universal Product Code (or UPC), you are required to include the IdType and ItemId parameters. The value of the IdType parameter must be UPC.

Your request is missing a required parameter combination. When [Parameter One] equals [Restricted Value], [Parameter Two] must be present.
  • ItemLookup

AWS.MissingServiceParameter

You will receive this error message when the your request does not contain the required Service parameter.

Your request is missing the Service parameter. Please add the Service parameter to your request and retry. Valid values for the Service parameter include [ValidServicesList].All

AWS.ParameterOutOfRange

You will receive this error message when you submit a parameter value that exceeds or is lower than the range of valid values for the parameter. For example, ItemSearch allows you to fetch search results page using the ItemPage parameter. The range of values for ItemPage is 1 to 10. If you supply a value outside that range (less than 1 or greater than 10), you will receive this error.

The value you specified for [ParameterName] is invalid. Valid values must be between [LowerBound] and [UpperBound].
  • ItemSearch

  • ItemLookup

AWS.ParameterRepeatedInRequest

You receive this error message when you include the same parameter more than once in your request.

The parameter, [ParameterName], appeared more than once in your request.All

AWS.RestrictedParameterValueCombination

You will receive this error message when your request contains a combination of parameter values that are not permitted in the same request.

Your request contains a restricted parameter combination. When [Parameter One] equals [Restricted Value], [Parameter Two] cannot be present.All

AWS.ECommerceService.ExceededMaximumCartItems

You will receive this error message when you exceed the maximum quantity value allowed for items being added to a shopping cart.

You may not add more than [Maximum Item Quantity] items to the cart.
  • CartAdd

  • CartCreate

AWS.ECommerceService.InvalidCartId

You will receive this error message when the CartId you entered into your request is not recognized.

Your request contains an invalid value for CartId. Please check your CartId and retry your request.
  • CartAdd

  • CartClear

  • CartGet

  • CartModify

AWS.ECommerceService.InvalidHMAC

You will receive this error message when the shopping cart HMAC value you use in your request is not recognized by Product Advertising API. The HMAC value is a unique token that is used to associate a cart with an Amazon user and a particular session on the Amazon web site.

Your request contains an invalid value for HMAC. Please check your HMAC and retry your request. Remember that the HMAC must be URL-encoded if you are using REST.
  • CartAdd

  • CartClear

  • CartGet

  • CartModify

AWS.ECommerceService.InvalidQuantity

You will receive this error message when the quantity in your request is not valid for the current item.

You have exceeded the maximum quantity allowed for the following item(s): [ItemId].
  • CartAdd

  • CartCreate

  • CartModify

AWS.ECommerceService.ItemAlreadyInCart

You will receive this error message when you try to add an item to a shopping cart that already contains that item.

The item you specified, [ItemID], is already in your cart.
  • CartAdd

  • CartCreate

AWS.ECommerceService.ItemNotAccessible

Some products cannot be manipulated or viewed using Product Advertising API. You will receive this error message when the product ID you use in your request is not available through Product Advertising API.

This item is not accessible through Product Advertising API.
  • ItemLookup

AWS.ECommerceService.ItemNotEligibleForCart

Some products cannot be manipulated or viewed using Product Advertising API. You will receive this error message when you attempt to add such an item to a remote shopping cart.

The item you specified, [ItemID], is not eligible to be added to the cart. Check the item's availability to make sure it is available.
  • CartAdd

  • CartCreate

  • CartModify

AWS.ECommerceService.NoExactMatches

We did not find any matches for your request.
  • ItemSearch

AWS.ECommerceService.NoSimilarities

There are no similar items for this ASIN(s): [ItemID].
  • SimilarityLookup

AccountLimitExceeded

You will receive this error if your application is trying to submit requests that exceed the maximum hourly request limit for your account

Account limit of X requests per hour exceeded (X = the hourly request limit for your account)

All

RequestThrottled

You will receive this error if your application is submitting requests faster than once per second per IP address.

You will receive this error if your application is submitting requests faster than once per second per IP address.