Guides
My Account

Get recommendation trends API

Overview

The Get recommendation trends API provides suggestions based on market trends, customer preferences, and gaps in your product availability.

Endpoint

GET https://marketplace.walmartapis.com/v3/growth/assortment/recommendations/trends

Functionality

This API helps you:

  • Inspect historical price movement and seasonality before listing an item
  • Identify customer item favorites.
  • Study seasonal high-demand trends to plan promotions or inventory
  • Feed a trend series into a dashboard or machine learning model to conduct forecasting

Request sample

curl --request GET \ --url https://marketplace.walmartapis.com/v3/growth/assortment/recommendations/trends \ --header 'accept: application/json'

import requests url = "https://marketplace.walmartapis.com/v3/growth/assortment/recommendations" headers = { "accept": "application/json", "content-type": "application/json", # Include your auth + required Walmart headers as applicable in your integration.
} payload = { "recommendationType": "ITEM", "meta": {"limit": 2}
} resp = requests.post(url, headers=headers, json=payload, timeout=30)
resp.raise_for_status()
print(resp.json())

Modify your code

Add authentication headers
Include your Marketplace auth headers. 

\--header 'Authorization: Bearer \<ACCESS_TOKEN>' \\ \--header 'WM_CONSUMER.ID: \<CONSUMER_ID>' \\ \--header 'WM_QOS.CORRELATION_ID: <unique-id>'

Response sample — All trends

{ "payload": { "recommendationUniqueId": "1033913643", "trends": [ { "trendType": "PRICE_TRENDS", "trendData": [ { "meta": { "currency": "USD" }, "monthlyTrends": [ { "month": "JUN", "year": "2023", "value": 10.99 }, { "month": "JUL", "year": "2023", "value": 24.83 }, { "month": "AUG", "year": "2023", "value": 20.44 }, { "month": "SEP", "year": "2023", "value": 10.99 }, { "month": "OCT", "year": "2023", "value": 10.99 }, { "month": "NOV", "year": "2023", "value": 10.99 }, { "month": "DEC", "year": "2023", "value": 10.99 }, { "month": "JAN", "year": "2024", "value": 10.99 }, { "month": "FEB", "year": "2024", "value": 14.03 }, { "month": "MAR", "year": "2024", "value": 11.99 }, { "month": "APR", "year": "2024", "value": 11.99 }, { "month": "MAY", "year": "2024", "value": 11.99 } ], "weeklyTrends": [ { "week": "23", "year": "2023", "value": 10.99 }, { "week": "24", "year": "2023", "value": 10.99 }, { "week": "25", "year": "2023", "value": 10.99 }, { "week": "26", "year": "2023", "value": 10.99 }, { "week": "27", "year": "2023", "value": 10.99 }, { "week": "28", "year": "2023", "value": 10.99 }, { "week": "29", "year": "2023", "value": 19.99 }, { "week": "30", "year": "2023", "value": 19.99 }, { "week": "31", "year": "2023", "value": 24.83 }, { "week": "32", "year": "2023", "value": 24.83 }, { "week": "33", "year": "2023", "value": 24.83 }, { "week": "34", "year": "2023", "value": 22.9 }, { "week": "35", "year": "2023", "value": 20.44 }, { "week": "36", "year": "2023", "value": 20.44 }, { "week": "37", "year": "2023", "value": 10.99 }, { "week": "38", "year": "2023", "value": 10.99 }, { "week": "39", "year": "2023", "value": 10.99 }, { "week": "40", "year": "2023", "value": 10.99 }, { "week": "41", "year": "2023", "value": 10.99 }, { "week": "42", "year": "2023", "value": 10.99 }, { "week": "43", "year": "2023", "value": 10.99 }, { "week": "44", "year": "2023", "value": 10.99 }, { "week": "45", "year": "2023", "value": 10.99 }, { "week": "46", "year": "2023", "value": 10.99 }, { "week": "47", "year": "2023", "value": 10.99 }, { "week": "48", "year": "2023", "value": 10.99 }, { "week": "49", "year": "2023", "value": 10.99 }, { "week": "50", "year": "2023", "value": 14.9 }, { "week": "51", "year": "2023", "value": 14.9 }, { "week": "52", "year": "2023", "value": 10.99 }, { "week": "1", "year": "2024", "value": 14.9 }, { "week": "2", "year": "2024", "value": 10.99 }, { "week": "3", "year": "2024", "value": 14.99 }, { "week": "4", "year": "2024", "value": 14.98 }, { "week": "5", "year": "2024", "value": 10.99 }, { "week": "6", "year": "2024", "value": 14.38 }, { "week": "7", "year": "2024", "value": 14.37 }, { "week": "8", "year": "2024", "value": 14.37 }, { "week": "9", "year": "2024", "value": 14.03 }, { "week": "10", "year": "2024", "value": 13.97 }, { "week": "11", "year": "2024", "value": 11.89 }, { "week": "12", "year": "2024", "value": 10.6 }, { "week": "13", "year": "2024", "value": 11.99 }, { "week": "14", "year": "2024", "value": 11.99 }, { "week": "15", "year": "2024", "value": 11.99 }, { "week": "16", "year": "2024", "value": 11.46 }, { "week": "17", "year": "2024", "value": 11.99 }, { "week": "18", "year": "2024", "value": 11.99 }, { "week": "19", "year": "2024", "value": 11.99 }, { "week": "20", "year": "2024", "value": 11.97 }, { "week": "21", "year": "2024", "value": 11.97 }, { "week": "22", "year": "2024", "value": 11.97 } ] } ] }, { "trendType": "DEMAND_TRENDS", "trendData": [ { "meta": {}, "monthlyTrends": [ { "month": "JAN", "value": 0.05 }, { "month": "FEB", "value": 0.05 }, { "month": "MAR", "value": 0.06 }, { "month": "APR", "value": 0.05 }, { "month": "MAY", "value": 0.04 }, { "month": "JUN", "value": 0.03 }, { "month": "JUL", "value": 0.04 }, { "month": "AUG", "value": 0.04 }, { "month": "SEP", "value": 0.04 }, { "month": "OCT", "value": 0.07 }, { "month": "NOV", "value": 0.26 }, { "month": "DEC", "value": 0.26 } ], "weeklyTrends": [ { "week": "1", "value": 0.02 }, { "week": "2", "value": 0.01 }, { "week": "3", "value": 0.01 }, { "week": "4", "value": 0.01 }, { "week": "5", "value": 0.01 }, { "week": "6", "value": 0.02 }, { "week": "7", "value": 0.02 }, { "week": "8", "value": 0.01 }, { "week": "9", "value": 0.02 }, { "week": "10", "value": 0.02 }, { "week": "11", "value": 0.02 }, { "week": "12", "value": 0.02 }, { "week": "13", "value": 0.02 }, { "week": "14", "value": 0.01 }, { "week": "15", "value": 0.01 }, { "week": "16", "value": 0.01 }, { "week": "17", "value": 0.01 }, { "week": "18", "value": 0.01 }, { "week": "19", "value": 0.01 }, { "week": "20", "value": 0.01 }, { "week": "21", "value": 0.01 }, { "week": "22", "value": 0.01 }, { "week": "23", "value": 0.01 }, { "week": "24", "value": 0.01 }, { "week": "25", "value": 0.01 }, { "week": "26", "value": 0.01 }, { "week": "27", "value": 0.01 }, { "week": "28", "value": 0.01 }, { "week": "29", "value": 0.01 }, { "week": "30", "value": 0.01 }, { "week": "31", "value": 0.01 }, { "week": "32", "value": 0.01 }, { "week": "33", "value": 0.01 }, { "week": "34", "value": 0.01 }, { "week": "35", "value": 0.01 }, { "week": "36", "value": 0.01 }, { "week": "37", "value": 0.01 }, { "week": "38", "value": 0.01 }, { "week": "39", "value": 0.01 }, { "week": "40", "value": 0.01 }, { "week": "41", "value": 0.02 }, { "week": "42", "value": 0.02 }, { "week": "43", "value": 0.02 }, { "week": "44", "value": 0.02 }, { "week": "45", "value": 0.04 }, { "week": "46", "value": 0.04 }, { "week": "47", "value": 0.06 }, { "week": "48", "value": 0.08 }, { "week": "49", "value": 0.07 }, { "week": "50", "value": 0.07 }, { "week": "51", "value": 0.07 }, { "week": "52", "value": 0.03 } ] } ] } ] }
}

Response sample — Price trends

{ "payload": { "recommendationUniqueId": "1033913643", "trends": [ { "trendType": "PRICE_TRENDS", "trendData": [ { "meta": { "currency": "USD" }, "monthlyTrends": [ { "month": "JUN", "year": "2023", "value": 10.99 }, { "month": "JUL", "year": "2023", "value": 24.83 }, { "month": "AUG", "year": "2023", "value": 20.44 }, { "month": "SEP", "year": "2023", "value": 10.99 }, { "month": "OCT", "year": "2023", "value": 10.99 }, { "month": "NOV", "year": "2023", "value": 10.99 }, { "month": "DEC", "year": "2023", "value": 10.99 }, { "month": "JAN", "year": "2024", "value": 10.99 }, { "month": "FEB", "year": "2024", "value": 14.03 }, { "month": "MAR", "year": "2024", "value": 11.99 }, { "month": "APR", "year": "2024", "value": 11.99 }, { "month": "MAY", "year": "2024", "value": 11.99 } ], "weeklyTrends": [ { "week": "23", "year": "2023", "value": 10.99 }, { "week": "24", "year": "2023", "value": 10.99 }, { "week": "25", "year": "2023", "value": 10.99 }, { "week": "26", "year": "2023", "value": 10.99 }, { "week": "27", "year": "2023", "value": 10.99 }, { "week": "28", "year": "2023", "value": 10.99 }, { "week": "29", "year": "2023", "value": 19.99 }, { "week": "30", "year": "2023", "value": 19.99 }, { "week": "31", "year": "2023", "value": 24.83 }, { "week": "32", "year": "2023", "value": 24.83 }, { "week": "33", "year": "2023", "value": 24.83 }, { "week": "34", "year": "2023", "value": 22.9 }, { "week": "35", "year": "2023", "value": 20.44 }, { "week": "36", "year": "2023", "value": 20.44 }, { "week": "37", "year": "2023", "value": 10.99 }, { "week": "38", "year": "2023", "value": 10.99 }, { "week": "39", "year": "2023", "value": 10.99 }, { "week": "40", "year": "2023", "value": 10.99 }, { "week": "41", "year": "2023", "value": 10.99 }, { "week": "42", "year": "2023", "value": 10.99 }, { "week": "43", "year": "2023", "value": 10.99 }, { "week": "44", "year": "2023", "value": 10.99 }, { "week": "45", "year": "2023", "value": 10.99 }, { "week": "46", "year": "2023", "value": 10.99 }, { "week": "47", "year": "2023", "value": 10.99 }, { "week": "48", "year": "2023", "value": 10.99 }, { "week": "49", "year": "2023", "value": 10.99 }, { "week": "50", "year": "2023", "value": 14.9 }, { "week": "51", "year": "2023", "value": 14.9 }, { "week": "52", "year": "2023", "value": 10.99 }, { "week": "1", "year": "2024", "value": 14.9 }, { "week": "2", "year": "2024", "value": 10.99 }, { "week": "3", "year": "2024", "value": 14.99 }, { "week": "4", "year": "2024", "value": 14.98 }, { "week": "5", "year": "2024", "value": 10.99 }, { "week": "6", "year": "2024", "value": 14.38 }, { "week": "7", "year": "2024", "value": 14.37 }, { "week": "8", "year": "2024", "value": 14.37 }, { "week": "9", "year": "2024", "value": 14.03 }, { "week": "10", "year": "2024", "value": 13.97 }, { "week": "11", "year": "2024", "value": 11.89 }, { "week": "12", "year": "2024", "value": 10.6 }, { "week": "13", "year": "2024", "value": 11.99 }, { "week": "14", "year": "2024", "value": 11.99 }, { "week": "15", "year": "2024", "value": 11.99 }, { "week": "16", "year": "2024", "value": 11.46 }, { "week": "17", "year": "2024", "value": 11.99 }, { "week": "18", "year": "2024", "value": 11.99 }, { "week": "19", "year": "2024", "value": 11.99 }, { "week": "20", "year": "2024", "value": 11.97 }, { "week": "21", "year": "2024", "value": 11.97 }, { "week": "22", "year": "2024", "value": 11.97 } ] } ] } ] }
}

import requests url = "https://marketplace.walmartapis.com/v3/growth/assortment/recommendations" headers = { "WM_GLOBAL_VERSION": "3.1", "WM_MARKET": "us", "accept": "application/json", "content-type": "application/json", # Include your auth + required Walmart headers as applicable in your integration.
} payload = { "recommendationType": "ITEM", "meta": { "limit": 4, "nextCursor": "AoRYPgVANXFt6AeR8QUAAAAAAAAAADkxMDEwMDMwNTZBTkRBTkRCMDg3WVYxOU05" }, "filterCriteria": { "searchText": "and", "multiValueFilter": [ {"parameter": "BRAND", "values": ["Disney", "NINTENDO"]}, {"parameter": "CATEGORY", "values": ["Toys"]}, {"parameter": "PRODUCT_TYPE", "values": ["Action Figure Sets", "Power Tool Batteries", "Action Figures"]}, ], "enumFilter": [ {"parameter": "ITEM_AVAILABILITY_STATUS", "values": ["NEW_TO_WALMART", "EXISTING_IN_WALMART"]}, {"parameter": "SHOPPING_TRENDS", "values": ["MOST_SEARCHED_FOR", "BEST_SELLERS", "DEAL_ITEMS"]}, {"parameter": "DEMAND_SALES_TRENDS", "values": ["DEC", "APR", "NOV", "MAR"]}, ], "rangeFilter": [ {"parameter": "PRICE", "from": "1.0", "to": "3.5"} ], "isTopGoGetItem": True, "isNewRecommendation": True, },
} resp = requests.post(url, headers=headers, json=payload, timeout=30)
resp.raise_for_status()
print(resp.json())

Modify your code

Response sample — Demand trends

{ "payload": { "recommendationUniqueId": "1033913643", "trends": [ { "trendType": "DEMAND_TRENDS", "trendData": [ { "meta": {}, "monthlyTrends": [ { "month": "JAN", "value": 0.05 }, { "month": "FEB", "value": 0.05 }, { "month": "MAR", "value": 0.06 }, { "month": "APR", "value": 0.05 }, { "month": "MAY", "value": 0.04 }, { "month": "JUN", "value": 0.03 }, { "month": "JUL", "value": 0.04 }, { "month": "AUG", "value": 0.04 }, { "month": "SEP", "value": 0.04 }, { "month": "OCT", "value": 0.07 }, { "month": "NOV", "value": 0.26 }, { "month": "DEC", "value": 0.26 } ], "weeklyTrends": [ { "week": "1", "value": 0.02 }, { "week": "2", "value": 0.01 }, { "week": "3", "value": 0.01 }, { "week": "4", "value": 0.01 }, { "week": "5", "value": 0.01 }, { "week": "6", "value": 0.02 }, { "week": "7", "value": 0.02 }, { "week": "8", "value": 0.01 }, { "week": "9", "value": 0.02 }, { "week": "10", "value": 0.02 }, { "week": "11", "value": 0.02 }, { "week": "12", "value": 0.02 }, { "week": "13", "value": 0.02 }, { "week": "14", "value": 0.01 }, { "week": "15", "value": 0.01 }, { "week": "16", "value": 0.01 }, { "week": "17", "value": 0.01 }, { "week": "18", "value": 0.01 }, { "week": "19", "value": 0.01 }, { "week": "20", "value": 0.01 }, { "week": "21", "value": 0.01 }, { "week": "22", "value": 0.01 }, { "week": "23", "value": 0.01 }, { "week": "24", "value": 0.01 }, { "week": "25", "value": 0.01 }, { "week": "26", "value": 0.01 }, { "week": "27", "value": 0.01 }, { "week": "28", "value": 0.01 }, { "week": "29", "value": 0.01 }, { "week": "30", "value": 0.01 }, { "week": "31", "value": 0.01 }, { "week": "32", "value": 0.01 }, { "week": "33", "value": 0.01 }, { "week": "34", "value": 0.01 }, { "week": "35", "value": 0.01 }, { "week": "36", "value": 0.01 }, { "week": "37", "value": 0.01 }, { "week": "38", "value": 0.01 }, { "week": "39", "value": 0.01 }, { "week": "40", "value": 0.01 }, { "week": "41", "value": 0.02 }, { "week": "42", "value": 0.02 }, { "week": "43", "value": 0.02 }, { "week": "44", "value": 0.02 }, { "week": "45", "value": 0.04 }, { "week": "46", "value": 0.04 }, { "week": "47", "value": 0.06 }, { "week": "48", "value": 0.08 }, { "week": "49", "value": 0.07 }, { "week": "50", "value": 0.07 }, { "week": "51", "value": 0.07 }, { "week": "52", "value": 0.03 } ] } ] } ] }
}

Result

  • You can get time-series price and demand data with specific recommendations (recommendationUniqueId).
  • monthlyTrends provide coarse seasonality signals.
  • weeklyTrends shows short-term fluctuations.
  • trendType groups available series (for example, PRICE_TRENDS, DEMAND_TRENDS).
  • meta could contain units or currency (for example, USD).

Next steps

Updated 3 days ago