Walmart Product Research

Walmart Search

Search Walmart product listings by keyword, category, price range, and other filters. Call the Walmart Search API via REST or MCP from 21 credits per call.

MCP tool name

nexscope_walmart_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "walmart-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_walmart_search",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "spelling": true
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`keyword`	`string`	optional	Search keyword, max length 1024 characters. *At least one of keyword and categoryId must be provided Example: phone case
`categoryId`	`string`	optional	Category ID. *At least one of keyword and categoryId must be provided. 0 means all departments. For example: 976759_976787 means "Cookies" Example: 976759_976787
`sort`	`string`	optional	Sort method. Options: price_low (price low to high), price_high (price high to low), best_seller (best seller), best_match (best match) Example: {}
`page`	`integer`	optional	Page number for pagination, default 1, max 100 Example: 1
`minPrice`	`number`	optional	Minimum price Example: 1
`maxPrice`	`number`	optional	Maximum price Example: 1
`spelling`	`boolean`	optional	Enable spelling correction, default true. true includes spelling correction, false excludes it Example: true
`softSort`	`boolean`	optional	Sort by relevance, default true. Set to false to disable relevance sorting Example: true
`storeId`	`string`	optional	Store ID, used to filter products by a specific store Example: example-id
`device`	`string`	optional	Device type, default desktop. Options: desktop, tablet, mobile Example: desktop
`facet`	`string`	optional	Filter conditions, format as key:value pairs separated by \ Example: {}
`nextDayEnabled`	`boolean`	optional	Only show NextDay delivery results, default false. true to enable, false to disable Example: false
`jsonRestrictor`	`string`	optional	JSON field restrictor Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of records. Example: {}
`products`	`array`	optional	Product list, element fields are shown in the table below. Example: {}
`columns`	`array`	optional	Rendered columns. Example: {}
`type`	`string`	optional	Rendering style. Example: {}
`costToken`	`integer`	optional	The number of tokens consumed. Example: {}
`productId`	`string`	optional	Product ID. Example: {}
`usItemId`	`string`	optional	US product ID. Example: {}
`title`	`string`	optional	Product title. Example: {}
`description`	`string`	optional	Product description. Example: {}
`price`	`number`	optional	current price. Example: {}
`wasPrice`	`number`	optional	Original price. Example: {}
`currency`	`string`	optional	monetary unit. Example: {}
`minPrice`	`number`	optional	lowest price. Example: {}
`pricePerUnitAmount`	`string`	optional	Unit price amount. Example: {}
`pricePerUnit`	`string`	optional	Unit price. Example: {}
`rating`	`number`	optional	Rating. Example: {}
`reviews`	`integer`	optional	Number of reviews. Example: {}
`sellerName`	`string`	optional	Seller name. Example: {}
`sellerId`	`string`	optional	Seller ID. Example: {}
`imageUrl`	`string`	optional	Product thumbnail URL. Example: {}
`productPageUrl`	`string`	optional	Product page URL. Example: {}
`sponsored`	`boolean`	optional	Whether it is a sponsored product. Example: {}
`outOfStock`	`boolean`	optional	Is it out of stock? Example: {}
`freeShipping`	`boolean`	optional	Is shipping free? Example: {}
`twoDayShipping`	`boolean`	optional	Whether to support two-day shipping. Example: {}
`freeShippingWithWalmartPlus`	`boolean`	optional	Is shipping free for Walmart Plus members? Example: {}
`shippingPrice`	`number`	optional	Shipping costs. Example: {}
`multipleOptionsAvailable`	`boolean`	optional	Are there multiple options. Example: {}
`variantSwatches`	`array`	optional	Sample list of variants; each contains `name`, `imageUrl`, `productPageUrl`, `variantFieldId`. Example: {}
`sourceType`	`string`	optional	Source type: `walmart`. Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "page": 1,
  "spelling": true
}

Example structuredContent

{}