Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

GetLastUpdatedTimeForRecommendations

Checks whether there are active recommendations for each category for the given marketplace, and if there are, returns the time when recommendations were last updated for each category.

Description

The GetLastUpdatedTimeForRecommendations operation enables you to check whether there are active recommendations for you in a given recommendation category, and if there are, to check when the recommendations for that category were last updated.

If the last updated timestamp returned for a category in this operation is newer than the last updated timestamp returned for a category when you last called this operation, then you should call the ListRecommendations operation again to get your latest recommendations for that category. Otherwise, there is no need to call the ListRecommendations operation because you already have the most current set of recommendations.

Note: Currently the last updated timestamp is not returned for listing quality recommendations.

If a null last updated timestamp is returned for a given category, then there are no active recommendations for you in that category.

Availability

This operation is available in all marketplaces.

The FulfillmentRecommendationsLastUpdated and AdvertisingRecommendationsLastUpdated elements are used in all marketplaces except Brazil.

Throttling

This operation has a maximum request quota of 8 and a restore rate of one request every two seconds. For definitions of throttling terminology and for a complete explanation of throttling, see Throttling: Limits to how often you can submit requests in the Amazon MWS Developer Guide.

Request parameters

For more information about the request parameters that are required for all Amazon MWS operations, see Required request parameters in the Amazon MWS Developer Guide.

Name Description Required Valid values
MarketplaceId The marketplace identifier for the marketplace from which you want to retrieve recommendations. Yes Any valid marketplace identifier that you are registered in.

Type: xs:string

Response elements

Name Description
InventoryRecommendationsLastUpdated The date and time when the inventory recommendations were last updated. In ISO 8601 date time format.

Type: xs:dateTime

PricingRecommendationsLastUpdated The date and time when the pricing recommendations were last updated. In ISO 8601 date time format.

Type: xs:dateTime

FulfillmentRecommendationsLastUpdated The date and time when the fulfillment recommendations were last updated. In ISO 8601 date time format. This element is used in all marketplaces except Brazil.

Optional

Type: xs:dateTime

GlobalSellingRecommendationsLastUpdated The date and time when the global selling recommendations were last updated. In ISO 8601 date time format.

Type: xs:dateTime

AdvertisingRecommendationsLastUpdated The date and time when the advertising recommendations were last updated. In ISO 8601 date time format. This element is used in all marketplaces except Brazil.

Optional

Type: xs:dateTime

Note: Last updated times are not returned for ListingQuality recommendations.

Examples

Example query request

For information about standard request requirements, see Required request parameters.

Show example code Hide example code

POST /Recommendations/2013-04-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header>

AWSAccessKeyId=0PB842EXAMPLESDX
&Action= GetLastUpdatedTimeForRecommendations
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&MarketplaceId=ATVPDKIKX0DER
&SellerId=0PB842EXAMPLESDX
&SignatureMethod=HmacSHA256 
&SignatureVersion=2
&Timestamp=2013-03-04T18%3A12%3A21.687Z
&Signature=ZQLpf8vEXAMPLE0iC265pf18n0%3D

↑ Top

Example response

For information about standard response formatting, see Response format.

Show example code Hide example code

<?xml version="1.0"?>
<GetLastUpdatedTimeForRecommendationsResponse
    xmlns="https://mws.amazonservices.com/Recommendations/2013-04-01/"/>
<InventoryRecommendationsLastUpdated>
    2013-03-04T02:10:32+00:00
</InventoryRecommendationsLastUpdated>  
<!--<SelectionRecommendationsLastUpdated>
    2013-03-03T03:11:34+00:00
</SelectionRecommendationsLastUpdated>-->  
<PricingRecommendationsLastUpdated>
    2013-03-05T03:11:33+00:00
</PricingRecommendationsLastUpdated>  
<FulfillmentRecommendationsLastUpdated>
    2013-03-02T03:11:32+00:00
</FulfillmentnRecommendationsLastUpdated>  
<GlobalSellingRecommendationsLastUpdated>
    2013-03-02T04:31:32+00:00
</GlobalSellingRecommendationsLastUpdated>  
<AdvertisingRecommendationsLastUpdated>
    2013-03-03T17:45:11+00:00
</AdvertisingRecommendationsLastUpdated>  
<ResponseMetadata>
    <RequestId>88faca76-b600-46d2-b53c-0c8c4EXAMPLE</RequestId>
</ResponseMetadata>
</GetLastUpdatedTimeForRecommendationsResponse>

↑ Top