--- updatedAt: 2026-06-04T12:53:29.000Z --- # Seller Listing Quality Score Get the total Listing Quality Score for a seller's entire item catalog. [block:html] { "html": "\n \n" } [/block] # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Insights Management", "version": "1.0", "description": "The Insights Management API provides sellers with actionable information to optimize their listings:\n* Sellers can locate best-selling items with Trending Items API so they can add those to their catalog of item offerings. \n* Sellers can find out reasons why items go unpublished, fix the issue and republish those items.\n* Sellers can use Listing Quality APIs to gather listing quality metrics about their items and identify any issues that they can fix.\n* Sellers can obtain their overall Listing Quality score, and locate any categories that show items with listing quality issues." }, "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" } ], "security": [ { "accessToken": [] } ], "paths": { "/v3/insights/items/listingQuality/score": { "get": { "tags": [ "Insight", "Listing Quality" ], "summary": "Seller Listing Quality Score", "description": "Get the total Listing Quality Score for a seller's entire item catalog.", "externalDocs": { "description": "View Guide", "url": "/doc/us/mp/us-mp-insights/#3880" }, "operationId": "getListingQualityScore", "parameters": [ { "name": "viewTrendingItems", "in": "query", "description": "Specify whether or not to include seller's items that are trending in the Listing Quality Score.", "required": false, "schema": { "type": "boolean" } }, { "name": "wfsFlag", "in": "query", "description": "Specify whether or not to include WFS-eligible items in the overall Listing Quality Score.", "required": false, "schema": { "type": "string" } }, { "in": "header", "name": "Authorization", "description": "Basic authorization header. Base 64 encodes the Client ID and Client Secret retrieved in step two of the integration steps.", "required": true, "schema": { "type": "string" }, "example": "Basic YzcyOTFjNmItNzI5MC00...." }, { "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token obtained from the Token API. This is required for authenticating requests to Walmart Marketplace APIs.", "required": true, "schema": { "type": "string" }, "example": "eyJraWQiOiIxNWNhNGIyYi0yODVjLTQ0ZDUtYmExNC05ZDk1NTlkZmUwNjgiLCJlbmMiOiJBMjU2R0NNIiwiYWxnIjoiZGlyIn0...." }, { "in": "header", "name": "WM_CONSUMER.CHANNEL.TYPE", "description": "A unique ID to identify 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 that identifies each API call and is used to track and debug issues. Use a randomly generated GUID for this ID.", "required": true, "schema": { "type": "string" }, "example": "b3261d2d-028a-4ef7-8602-633c23200af6" }, { "in": "header", "name": "WM_SVC.NAME", "description": "Specifies the name of the Walmart service being called.", "required": true, "schema": { "type": "string" }, "example": "Walmart Marketplace" } ], "responses": { "200": { "description": "Successful Operation", "content": { "application/json": { "schema": { "type": "object", "properties": { "payload": { "type": "object", "properties": { "listingQuality": { "type": "number", "description": "Listing Quality ", "format": "double" }, "score": { "type": "object", "properties": { "offerScore": { "type": "number", "description": "Offer Score", "format": "double" }, "contentScore": { "type": "number", "description": "Content Score", "format": "double" }, "ratingReviewScore": { "type": "number", "description": "Rating Review Score", "format": "double" }, "competitivePriceScore": { "type": "number", "description": "Competitive Price Score", "format": "double" }, "shippingScore": { "type": "number", "description": "Shipping Score", "format": "double" }, "transactibilityScore": { "type": "number", "description": "Rating Review Score", "format": "double" } }, "description": "Score" }, "postPurchaseQuality": { "type": "object", "properties": { "defectRatio": { "type": "integer", "description": "Defect Ratio", "format": "int32" }, "itemDefectCnt": { "type": "integer", "description": "Item Defect Count", "format": "int32" } }, "description": "Post Purchase Quality" } } } } }, "example": { "payload": { "score": { "offerScore": 50, "ratingReviewScore": 14.48, "contentScore": 64.24, "competitivePriceScore": 64.24, "shippingScore": 64.24, "transactibilityScore": 64.24 }, "postPurchaseQuality": { "itemDefectCnt": 0, "defectRatio": 0 }, "listingQuality": 44.7 }, "status": "OK" } } } } } } } }, "components": { "securitySchemes": { "accessToken": { "type": "apiKey", "in": "header", "name": "WM_SEC.ACCESS_TOKEN", "description": "Access token required for authenticating API requests.\n\nTo obtain a token, call `POST https://marketplace.walmartapis.com/v3/token` with your client ID and client secret using the client credentials grant type. Refer to the [Token API documentation](https://developer.walmart.com/us-marketplace/docs/get-an-access-token) for details.\n\nPass the resulting token in the `WM_SEC.ACCESS_TOKEN` header with every API request." } } } } ```