Walmart Product Detail

Look up Walmart product details, price history, and sales trends. Call the Walmart Product Detail API via REST or MCP from 29 credits per call.

CostRecent Avg. 41 · Range 22–44 credits / call

Try online

POST · https://api.nexscope.ai/ws/productDetailMCP · nexscope_walmart_product_detail

What this API does

Look up Walmart product details, price history, and sales trends. The request accepts productId, includeStats. Its documented result includes products, usItemId, productId, title, description, price, wasPrice, minPrice.

Walmart Product Detail API use cases

Inspect a candidate product

To inspect a candidate product, a marketplace analyst submits productId and includeStats to Walmart Product Detail. The returned products, usItemId, productId help inspect the documented attributes of the candidate product.

Compare listing details

A marketplace analyst uses Walmart Product Detail with productId and includeStats to compare listing details. The returned products, usItemId, productId help compare product details with another shortlisted listing.

Prepare product evidence for a sourcing review

For this workflow, a marketplace analyst calls Walmart Product Detail with productId and includeStats to prepare product evidence for a sourcing review. The result helps record product facts before a sourcing discussion.

Walmart Product Detail API FAQ

What does the Walmart Product Detail API return?

Look up Walmart product details, price history, and sales trends. The documented output includes products, usItemId, productId, title, description, price, wasPrice, minPrice. It corresponds to the supplied productId, includeStats. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the Walmart Product Detail API cost?

The current documented cost is Recent Avg. 41 · Range 22–44 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Walmart Product Detail API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/ws/productDetail with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_walmart_product_detail. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and credits Connect this API with MCP

Try this API

Endpoint

https://api.nexscope.ai/ws/productDetail

MCP method

nexscope_walmart_product_detail

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/ws/productDetail

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/ws/productDetail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "includeStats": true,
  "productId": 5177343351
}'

Code example

{
  "includeStats": true,
  "productId": 5177343351
}

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

Code	Description
200	Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429	Execution admission rate limit; honor Retry-After when present.
503	Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-in	X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

View parameters & response Try online

All categories/ Walmart Product Research

POSThttps://api.nexscope.ai/ws/productDetail

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Open tester

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/ws/productDetail`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`productId`	`integer`	required	Item ID (Item ID), the numeric ID contained in the product details link, such as `5169493923` in `https://www.walmart.com/ip/5169493923`.
`includeStats`	`boolean`	optional	Whether to include historical price and historical sales data. Example: true

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

No response example is published for this API. Refer to the response fields below.

Response fields

Response field reference (38 fields)

Name	Type	Required	Description
`code`	`string`	optional	Return code; `"200"` indicates success.
`msg`	`string`	optional	Message; `"ok"` on success, error description on failure.
`total`	`integer`	optional	The quantity of goods returned is usually 1 for this interface.
`products`	`array`	optional	Product list, element fields are shown in the table below.
`columns`	`array`	optional	Column definition, describing the meta information of each field in `products`, including `field`, `title`, `cellType`, etc.
`type`	`string`	optional	Response rendering type, fixed value is `"productWorkbenches"`.
`costTime`	`integer`	optional	API latency in milliseconds
`costToken`	`integer`	optional	The number of tokens consumed.
`usItemId`	`integer`	optional	The product internal ID, which is `productId` in the request.
`productId`	`string`	optional	A unique identifier for the Walmart product, which may be an alphanumeric string.
`title`	`string`	optional	Product name.
`description`	`string`	optional	Product description.
`price`	`number`	optional	Current selling price in US dollars.
`wasPrice`	`number/null`	optional	Strikethrough price in USD; may be `null` without discount.
`minPrice`	`number`	optional	Lowest price in USD.
`brand`	`string`	optional	Brand name.
`rating`	`number`	optional	Product rating, ranging from 0.0–5.0.
`reviews`	`integer`	optional	Number of comments.
`salesEstimate`	`integer`	optional	Sales volume estimate for the recent cycle, in units.
`revenue`	`number`	optional	Revenue estimates in U.S. dollars.
`sellerName`	`string`	optional	Seller name.
`fulfillmentType`	`string`	optional	Shipping type: `MARKETPLACE` (fulfilled by third-party seller) or `WFS` (Walmart Fulfillment Services).
`productPageUrl`	`string`	optional	Product page URL.
`imageUrl`	`string`	optional	Product image URL (thumbnail).
`departmentName`	`string`	optional	The name of the department you belong to.
`departmentId`	`integer`	optional	Department ID.
`listingScore`	`integer`	optional	Listing quality score.
`contentScore`	`integer`	optional	Content quality points.
`outOfStock`	`integer`	optional	Whether it is out of stock: `0`=in stock, `1`=out of stock.
`sponsored`	`integer`	optional	Whether to advertise products: `0`=No, `1`=Yes.
`isBranded`	`integer`	optional	Whether it is a branded product: `0`=No, `1`=Yes.
`multipleOptionsAvailable`	`integer`	optional	Are there variations: `0`=No, `1`=Yes.
`createdAt`	`string`	optional	ws First collection time, in the format of `yyyy-MM-dd'T'HH:mm:ss.SSSSSS'Z'`.
`updatedAt`	`string`	optional	The last data update time, the format is the same as above.
`stats`	`object/null`	optional	Historical statistics; returned if `includeStats=true`, otherwise `null`.
`sourceType`	`string`	optional	Product source platform, fixed value is `"walmart"`.
`stats.price`	`array`	optional	Historical selling price time series, sorted by date in ascending order.
`stats.sales`	`array`	optional	Historical sales time series, sorted by date in ascending order.

Responses

Code	Description
200	Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429	Execution admission rate limit; honor Retry-After when present.
503	Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-in	X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json

Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_product_detail",
    "arguments": {
      "includeStats": true,
      "productId": "5169493923"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Data Example

Request parameters

{
  "productId": "17815415970",
  "includeStats": true
}

Response

{
  "code": 0,
  "msg": null,
  "data": {
    "total": 1,
    "costTime": 924,
    "columns": [
      {
        "filterable": true,
        "cellType": "number",
        "field": "usItemId",
        "sortable": true,
        "title": "商品内部ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productId",
        "sortable": true,
        "title": "Walmart商品ID"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "departmentId",
        "sortable": true,
        "title": "所属部门ID"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "departmentName",
        "sortable": true,
        "title": "所属部门名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "productPageUrl",
        "sortable": true,
        "title": "商品页面URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "imageUrl",
        "sortable": true,
        "title": "商品图片URL"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "title",
        "sortable": true,
        "title": "商品名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "description",
        "sortable": true,
        "title": "商品描述"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "price",
        "sortable": true,
        "title": "当前售价（美元）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "wasPrice",
        "sortable": true,
        "title": "划线价（美元）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "minPrice",
        "sortable": true,
        "title": "最低价格（美元）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "rating",
        "sortable": true,
        "title": "商品评分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "reviews",
        "sortable": true,
        "title": "评论数量（条）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "outOfStock",
        "sortable": true,
        "title": "是否缺货"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "sponsored",
        "sortable": true,
        "title": "是否广告商品"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "isBranded",
        "sortable": true,
        "title": "是否品牌商品"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "multipleOptionsAvailable",
        "sortable": true,
        "title": "是否有变体"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "fulfillmentType",
        "sortable": true,
        "title": "配送类型"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "brand",
        "sortable": true,
        "title": "品牌名称"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sellerName",
        "sortable": true,
        "title": "卖家名称"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "salesEstimate",
        "sortable": true,
        "title": "销量估算（件）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "revenue",
        "sortable": true,
        "title": "收入估算（美元）"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "contentScore",
        "sortable": true,
        "title": "内容质量分"
      },
      {
        "filterable": true,
        "cellType": "number",
        "field": "listingScore",
        "sortable": true,
        "title": "Listing评分"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "createdAt",
        "sortable": true,
        "title": "创建时间(yyyy-MM-dd'T'HH:mm:ss"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "updatedAt",
        "sortable": true,
        "title": "更新时间(yyyy-MM-dd'T'HH:mm:ss"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "stats",
        "sortable": true,
        "title": "历史统计数据（按天，UTC，按时间升序）"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceType",
        "sortable": true,
        "title": "商品来源"
      },
      {
        "filterable": true,
        "cellType": "text",
        "field": "sourceTool",
        "sortable": true,
        "title": "来源工具"
      }
    ],
    "type": "productWorkbenches",
    "products": [
      {
        "departmentName": "Electronics",
        "productId": "2VH6SH3M6F3P",
        "listingScore": 56,
        "departmentId": 10,
        "sellerName": "DemProductSales",
        "description": "The Acer Nitro V 16 ANV16S-41-R2AJ is a state-of-the-art AI gaming laptop designed to provide a competitive edge through advanced processing and brilliant visuals. At its core, the AMD Ryzen 7 260 processor features a sophisticated multi-core architecture with a dedicated NPU for localized AI acceleration, ensuring peak efficiency during intense gaming and creative multitasking. Graphical superiority is delivered by the NVIDIA GeForce RTX 5060 Laptop GPU, which utilizes the latest Blackwell architecture and 8GB of dedicated GDDR7 VRAM to produce lifelike ray-traced environments and AI-enhanced DLSS 4 frame rates. The expansive 16-inch WQXGA display features a 165Hz refresh rate and a 16:10 aspect ratio, providing ultra-smooth motion and expanded vertical screen real estate. Equipped with 16GB of high-speed DDR5 RAM and a massive 1TB PCIe Gen 4 SSD, this machine offers lightning-fast responsiveness and ample storage. The sophisticated dual-fan cooling system and NitroSense software maintain system stability in a sleek Obsidian Black chassis.",
        "sponsored": 0,
        "title": "Acer Nitro V 16 ANV16S-41-R2AJ Gaming Laptop 16\" WQXGA 165Hz AMD Ryzen 7 260 NVIDIA GeForce RTX 5060 16GB RAM 1TB SSD",
        "productPageUrl": "https://www.walmart.com/ip/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ/17815415970?classType=REGULAR",
        "createdAt": "2026-05-01T20:36:45.000000Z",
        "revenue": 26519.83,
        "sourceTool": "WallySmarter商品详情",
        "stats": {
          "price": [
            {
              "2026-05-04": 1559.99
            },
            {
              "2026-05-18": 1559.99
            },
            {
              "2026-06-01": 1559.99
            },
            {
              "2026-06-15": 1559.99
            },
            {
              "2026-06-29": 1559.99
            },
            {
              "2026-07-13": 1559.99
            },
            {
              "2026-07-20": 1559.99
            },
            {
              "2026-08-03": 1559.99
            },
            {
              "2026-08-24": 1559.99
            },
            {
              "2026-08-31": 1559.99
            },
            {
              "2026-09-21": 1559.99
            }
          ],
          "sales": [
            {
              "2026-05-04": 1
            },
            {
              "2026-05-18": 2
            },
            {
              "2026-06-01": 3
            },
            {
              "2026-06-15": 5
            },
            {
              "2026-06-29": 5
            },
            {
              "2026-07-13": 4
            },
            {
              "2026-07-20": 17
            },
            {
              "2026-08-03": 12
            },
            {
              "2026-08-24": 14
            },
            {
              "2026-08-31": 17
            },
            {
              "2026-09-21": 17
            }
          ]
        },
        "sourceType": "walmart",
        "usItemId": "17815415970",
        "price": 1559.99,
        "imageUrl": "https://i5.walmartimages.com/seo/Acer-Nitro-V-16S-AI-16-Gaming-Laptop-AMD-Ryzen-7-260-NVIDIA-GeForce-RTX-5060-8-GB-1TB-SSD-Windows-11-Home-ANV16S-41-R2AJ_3a6459a2-ca38-4fe9-9a3a-f25b5d74aa69.deba93f713d196d0dc94d10beb49f900.jpeg",
        "outOfStock": 0,
        "isBranded": 0,
        "contentScore": 67,
        "multipleOptionsAvailable": 0,
        "brand": "Acer",
        "salesEstimate": 17,
        "updatedAt": "2026-09-21T00:00:00.000000Z"
      }
    ]
  }
}

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

Recent Avg. 41 · Range 22–44 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint

/ws/productDetail

MCP method

nexscope_walmart_product_detail

API key*

JSON payload*

cURL

curl -X POST \
  https://api.nexscope.ai/ws/productDetail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "includeStats": true, "productId": 5177343351 }'

Response

No response yet. Run the request to see the response here.

Related APIs

Walmart Search

Search Walmart product listings by keyword, category, price range, and other filters.