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

ListRecommendationsByNextToken

Returns the next page of recommendations using the NextToken parameter.

Description

The ListRecommendationsByNextToken operation returns the next page of recommendations using the NextToken value that was returned by your previous request to either ListRecommendations or ListRecommendationsByNextToken. If NextToken is not returned, there are no more pages to return.

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
NextToken A string token returned in the response of your previous request to either ListRecommendations or ListRecommendationsByNextToken. Yes Type: xs:string

Response elements

Name Description
NextToken A generated string used to pass information to your next request. If NextToken is returned, pass the value of NextToken to ListRecommendationsByNextToken. If NextToken is not returned, there are no more recommendations to return.

Optional

Type: xs:string

FulfillmentRecommendations A list of current fulfillment recommendations.

The list is empty if there are no current fulfillment recommendations or if fulfillment recommendations were not requested in the RecommendationCategory. This element is used in all marketplaces except Brazil.

Optional

Type: List of FulfillmentRecommendation

InventoryRecommendations A list of current inventory recommendations.

The list is empty if there are no current inventory recommendations or if inventory recommendations were not requested in the RecommendationCategory.

Optional

Type: List of InventoryRecommendation

PricingRecommendations A list of current pricing recommendations.

The list is empty if there are no current pricing recommendations or if pricing recommendations were not requested in the RecommendationCategory.

Optional

Type: List of PricingRecommendation

GlobalSellingRecommendations A list of current global selling recommendations.

The list is empty if there are no current global selling recommendations or if global selling recommendations were not requested in the RecommendationCategory.

Optional

Type: List of GlobalSellingRecommendation

AdvertisingRecommendations A list of current advertising recommendations.

The list is empty if there are no current advertising recommendations or if advertising recommendations were not requested in the RecommendationCategory. This element is used in all marketplaces except Brazil.

Optional

Type: List of AdvertisingRecommendation

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= ListRecommendationsByNextToken
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&NextToken=88faca76-b600-46d2-b53c-0c8c4533e43a
&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"?>
<ListRecommendationsByNextTokenResponse
    xmlns="https://mws.amazonservices.com/Recommendations/2013-04-01">
    <ListRecommendationsByNextTokenResult>
        <NextToken>AAAAAAAAEXAMPLE+13sB+==</NextToken>
    </ListRecommendationsByNextTokenResult>
    <ResponseMetadata>
        <RequestId>b106b175-85ca-11e2-8826-c31d9EXAMPLE</RequestId>
    </ResponseMetadata>
</ListRecommendationsByNextTokenResponse>

↑ Top