--- updatedAt: 2026-04-23T19:00:11.000Z --- # Get Recommendation Trends You can fetch the monthly and weekly trends for both demand and price, for the assortment recommendations that are recommended for you. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Assortment Recommendations Overview", "version": "1.0", "description": "Assortment recommendations help sellers understand customer demand in Walmart and the external market by providing personalized item recommendations. These insights are generated by leveraging demand signals like: \n* Internal and external search \n* Best Sellers\n* Trending items\n\n The assortment recommendations API can be used to view Customer Favorites (In-demand items), demand trends, filter, reject, and bulk download the recommendations. These recommended items can be set up using the [Item Setup API](https://developer.walmart.com/api/us/mp/items).\nSellers need to provide API access key on [developer portal](https://developer.walmart.com/account/generateKey) for ‘Analytics & Growth’ to solution providers and channel partners to be able to access Assortment Growth APIs." }, "x-readme": { "samples-languages": [ "shell" ], "proxy-enabled": false }, "servers": [ { "url": "https://marketplace.walmartapis.com", "description": "Production URL" }, { "url": "https://sandbox.walmartapis.com", "description": "Sandbox URL" } ], "paths": { "/v3/growth/assortment/recommendations/trends": { "get": { "tags": [ "Assortment Recommendations" ], "summary": "Get Recommendation Trends", "description": "You can fetch the monthly and weekly trends for both demand and price, for the assortment recommendations that are recommended for you.", "externalDocs": { "description": "View Guide", "url": "/doc/us/us-mp/us-mp-assortmentrecommendations/#12957" }, "operationId": "getAssortmentRecommendationTrends", "parameters": [ { "name": "recommendationUniqueId", "in": "query", "description": "Unique ID that is returned in the response of the get recommendations API or in the on-request bulk CSV file", "required": true, "schema": { "type": "string", "externalDocs": { "description": "Get Recommendations API, Bulk Download Recommendations API", "url": "/doc/us/us-mp/us-mp-assortmentrecommendations/#12957" } } }, { "name": "trendTypes", "in": "query", "allowReserved": true, "description": "Comma separated list of trends\n\n | Attribute | Description | Data Type |\n| --- | ----------- | ------- |\n| PRICE_TRENDS | Indicates the price trends for the recommended item in the marketplace currency for rolling 52-weeks/12-months. The data may not be available for all weeks/months. | string |\n| DEMAND_TRENDS | Indicates the demand trends for the recommended item for 52-weeks/12-months. | string |", "schema": { "type": "string" }, "example": "PRICE_TRENDS,DEMAND_TRENDS" }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "The access token retrieved in the Token API call", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM....." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "WM_QOS.CORRELATION_ID", "description": "A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Walmart Service Name", "required": true, "schema": { "type": "string" }, "example": "Walmart Service Name" }, { "in": "header", "name": "Accept", "description": "Only supported Media Type : application/json", "required": true, "schema": { "type": "string" }, "example": "application/json" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "required": [ "recommendationUniqueId" ], "description": "Payload in the response having the trend details for the recommended item.", "type": "object", "properties": { "recommendationUniqueId": { "type": "string", "description": "Unique ID that is returned in the response of the get recommendations API or in the on-request bulk CSV file.", "externalDocs": { "description": "Get Recommendations API, Bulk Download Recommendations API", "url": "/doc/us/us-mp/us-mp-assortmentrecommendations/#12957" } }, "trends": { "type": "array", "description": "Trend data for the recommended item. This will include Price trends and Demand trends.", "items": { "type": "object", "properties": { "trendType": { "type": "string", "description": "Type of trend.\n\n Values: DEMAND_TRENDS, PRICE_TRENDS" }, "trendData": { "type": "array", "description": "Trend data for the recommended item. The array will be empty if trends are not available for the item.", "items": { "type": "object", "properties": { "meta": { "type": "object", "description": "Meta information related to the trends response.", "properties": { "currency": { "type": "string", "description": "Currency associated with the price trends of the recommendation.\n\n Value: USD" } } }, "monthlyTrends": { "type": "array", "description": "Trend data at a monthly level.", "items": { "type": "object", "properties": { "month": { "type": "string", "description": "Month of the year.\n\n Values: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC" }, "year": { "type": "string", "description": "Year of trend.\n\n Example: 2024" }, "value": { "type": "number", "description": "| Trend Type | Description | Data type of value |\n| --- | ----------- | ------- |\n| PRICE_TRENDS | Indicates the price of the item in the market specific currency for the given month and year. Example: 5.99 | double |\n| DEMAND_TRENDS | Normalised values to indicate relative demand for the recommendation for the given month. Example: 0.07 | double |", "format": "double" } } } }, "weeklyTrends": { "type": "array", "description": "Trend data at a weekly level.", "items": { "type": "object", "properties": { "week": { "type": "string", "description": "Week of the year. Example: 24" }, "year": { "type": "string", "description": "Year of trend. Example: 2024" }, "value": { "type": "number", "description": "| Trend Type | Description | Data type of value |\n| --- | ----------- | ------- |\n| PRICE_TRENDS | Indicates the price of the item in the market specific currency for the given week and year. Example: 6.54 | double |\n| DEMAND_TRENDS | Normalised values to indicate relative demand for the recommendation for the given week. Example: 0.08 | double |", "format": "double" } } } } } } } } } } } } } }, "examples": { "All trends": { "value": { "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 } ] } ] } ] } } }, "Price trends": { "value": { "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 } ] } ] } ] } } }, "Demand trends": { "value": { "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 } ] } ] } ] } } } } } } } } } } } } ```