Walmart Marketplace Intelligence
Walmart Keyword Research MCP Tool
Returns normalized public ecommerce research data with a fixed read-only provider path.
MCP tool name
nexscope_walmart_keyword_researchLegacy MCP endpoint
/api/skill-api/v1/mcpJSON-RPC method
tools/callAuthentication
Send the user API key as a bearer token on every MCP JSON-RPC request.
Authorization: Bearer nk-xxxxxxxxxxxxxxxxxIf authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.
Call this MCP tool
Use tools/call with the MCP tool name below. The arguments object should match the table on this page.
{
"jsonrpc": "2.0",
"id": "walmart-keyword-research-1",
"method": "tools/call",
"params": {
"name": "nexscope_walmart_keyword_research",
"arguments": {
"operation": "searchByName",
"name": "wireless earbuds",
"pageIndex": 1
}
}
}Legacy endpoint
POST /api/skill-api/v1/mcpCanonical detail URL
https://www.nexscope.ai/mcp-map/walmart-keyword-researchArguments
operation: marketQuery
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: marketQuery |
pattern | object | optional | Optional marketQuery filter object |
pattern.keyword | string | optional | Keyword filter inside pattern Minimum length: 1 |
pattern.rankCondition | array | optional | One- or two-value rank range Minimum items: 1 Maximum items: 2 |
pattern.rankCondition[] | integer | required | One- or two-value rank range Minimum: 0 |
pattern.searchVolumeCondition | array | optional | One- or two-value search-volume range Minimum items: 1 Maximum items: 2 |
pattern.searchVolumeCondition[] | integer | required | One- or two-value search-volume range Minimum: 0 |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
pageSize | integer | optional | Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200 |
operation: searchByName
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: searchByName |
name | string | required | Keyword name required by searchByName Minimum length: 1 |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
operation: searchProducts
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: searchProducts |
keyword | string | required | Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1 |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
pageSize | integer | optional | Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200 |
operation: detail
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: detail |
keyword | string | required | Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1 |
operation: productKeywords
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: productKeywords |
productId | string | required | Product ID required by productKeywords Minimum length: 1 |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
pageSize | integer | optional | Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200 |
operation: relatedKeywords
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: relatedKeywords |
keyword | string | required | Keyword required by searchProducts, detail, or relatedKeywords Minimum length: 1 |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
pageSize | integer | optional | Page size from 20 to 200 Default: 20 Minimum: 20 Maximum: 200 |
operation: favoriteList
| Name | Type | Required | Description |
|---|---|---|---|
operation | string | required | Walmart keyword research operation Constant: favoriteList |
command | any | required | Read-only favoriteList command: all, dict, or dict=<value> |
pageIndex | integer | optional | Page number, starting at 1 Default: 1 Minimum: 1 |
One of option 1
| Name | Type | Required | Description |
|---|---|---|---|
command | any | required | Read-only favoriteList command: all, dict, or dict=<value> Allowed: all, dict |
One of option 2
| Name | Type | Required | Description |
|---|---|---|---|
command | string | required | Read-only favoriteList command: all, dict, or dict=<value> Pattern: ^dict=.+$ |
Response fields
Treat structuredContent as the programmatic API response payload.
| Name | Type | Required | Description |
|---|---|---|---|
data | any | required | Data value used by this API operation. |
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
msg | string | null | required | Msg value used by this API operation. |
ts | string | required | Epoch milliseconds. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1 — requires operation, value, requestConsumed
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.operation | any | required | Operation value used by this API operation. |
data.value | any | required | Value value used by this API operation. |
data.requestConsumed | integer | required | Request consumed value used by this API operation. Minimum: 0 |
One of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.operation | any | optional | Operation value used by this API operation. Allowed: marketQuery, searchByName, searchProducts, productKeywords, relatedKeywords, favoriteList |
data.value | array | optional | Value value used by this API operation. |
operation: detail
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.operation | string | optional | Operation value used by this API operation. Constant: detail |
data.value | object | optional | Value value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Examples
Example arguments
{
"operation": "searchByName",
"name": "wireless earbuds",
"pageIndex": 1
}Example structuredContent
{
"data": {
"operation": "searchByName",
"requestConsumed": 1,
"value": [
{
"Keyword": "wireless earbuds",
"Rank": 1,
"SearchVolume": 1
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}