linkfox-walmart-search
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseWalmart Product Search
Walmart商品搜索
This skill enables you to search and retrieve Walmart product listing data, helping e-commerce sellers and researchers extract actionable insights from Walmart's marketplace.
本技能可帮助您搜索并获取沃尔玛商品listing数据，为电商卖家和研究人员从沃尔玛平台提取可落地的洞察信息。
Core Concepts
核心概念
Walmart Product Search retrieves real-time product listing data from Walmart's marketplace. It supports keyword-based search, category browsing, price filtering, sorting options, and device-specific results. This is a direct search tool that returns current product listings as they appear on Walmart.com.
Search modes: You can search by keyword, by category ID, or by combining both. At least one of or must be provided.
keywordcategoryIdSorting options: Results can be sorted by , , (price ascending), or (price descending). When no sort is specified, the default relevance-based ranking applies.
best_sellerbest_matchprice_lowprice_highPagination: Results are paginated with a default of page 1. The maximum page number is 100.
Walmart商品搜索从沃尔玛平台获取实时商品listing数据，支持关键词搜索、品类浏览、价格筛选、排序选项以及适配不同设备的结果展示。这是一款直接搜索工具，返回Walmart.com上当前展示的商品listing。
搜索模式：您可以通过关键词、品类ID，或结合两者进行搜索。必须提供或中的至少一项。
keywordcategoryId排序选项：结果可按（畅销优先）、（匹配优先）、（价格升序）或（价格降序）排序。未指定排序方式时，默认采用基于相关性的排名规则。
best_sellerbest_matchprice_lowprice_high分页：结果采用分页展示，默认显示第1页，最大页码为100。
Parameter Guide
参数指南
| Parameter | Type | Required | Description |
|---|---|---|---|
| keyword | string | No* | Search keyword (max 1024 chars). *At least one of keyword or categoryId must be provided |
| categoryId | string | No* | Category ID for browsing. *At least one of keyword or categoryId must be provided. Use |
| sort | string | No | Sort order: |
| page | integer | No | Page number (1-100, default 1) |
| minPrice | number | No | Minimum price filter |
| maxPrice | number | No | Maximum price filter |
| spelling | boolean | No | Enable spelling correction (default true) |
| softSort | boolean | No | Sort by relevance (default true). Set to false to disable |
| storeId | string | No | Store ID for store-specific results |
| device | string | No | Device type: |
| facet | string | No | Filter facets in |
| nextDayEnabled | boolean | No | Show only NextDay delivery results (default false) |
| jsonRestrictor | string | No | JSON field restrictor to limit returned fields |
| 参数（Parameter） | 类型（Type） | 必填（Required） | 描述（Description） |
|---|---|---|---|
| keyword | string | 否* | 搜索关键词（最多1024字符）。*必须提供keyword或categoryId中的至少一项 |
| categoryId | string | 否* | 用于浏览的品类ID。*必须提供keyword或categoryId中的至少一项，使用 |
| sort | string | 否 | 排序方式： |
| page | integer | 否 | 页码（1-100，默认值1） |
| minPrice | number | 否 | 最低价格筛选条件 |
| maxPrice | number | 否 | 最高价格筛选条件 |
| spelling | boolean | 否 | 启用拼写纠错（默认值true） |
| softSort | boolean | 否 | 按相关性排序（默认值true），设置为false可关闭该功能 |
| storeId | string | 否 | 特定门店的ID，用于获取该门店专属结果 |
| device | string | 否 | 设备类型： |
| facet | string | 否 | 筛选维度，格式为 |
| nextDayEnabled | boolean | 否 | 仅显示支持次日达的结果（默认值false） |
| jsonRestrictor | string | 否 | JSON字段限制器，用于限定返回的字段 |
Product Data Fields
商品数据字段
| Field | Description |
|---|---|
| productId | Walmart product ID |
| usItemId | US item ID |
| title | Product title |
| description | Product description |
| price | Current price |
| wasPrice | Original price before discount |
| currency | Currency code |
| minPrice | Minimum price (for multi-option products) |
| pricePerUnitAmount | Per-unit price amount |
| pricePerUnit | Per-unit price label |
| rating | Average rating score |
| reviews | Total number of reviews |
| sellerName | Seller name |
| sellerId | Seller ID |
| imageUrl | Product thumbnail URL |
| productPageUrl | Product detail page URL |
| sponsored | Whether the listing is a sponsored ad |
| outOfStock | Whether the product is out of stock |
| freeShipping | Whether free shipping is available |
| twoDayShipping | Whether two-day shipping is available |
| freeShippingWithWalmartPlus | Free shipping with Walmart Plus membership |
| shippingPrice | Shipping cost |
| multipleOptionsAvailable | Whether the product has multiple variants |
| variantSwatches | List of variant options with names and images |
| 字段（Field） | 描述（Description） |
|---|---|
| productId | Walmart商品ID |
| usItemId | 美国地区商品ID |
| title | 商品标题 |
| description | 商品描述 |
| price | 当前价格 |
| wasPrice | 折扣前原价 |
| currency | 货币代码 |
| minPrice | 最低价格（适用于多选项商品） |
| pricePerUnitAmount | 单位价格金额 |
| pricePerUnit | 单位价格标签 |
| rating | 平均评分 |
| reviews | 总评论数 |
| sellerName | 卖家名称 |
| sellerId | 卖家ID |
| imageUrl | 商品缩略图URL |
| productPageUrl | 商品详情页URL |
| sponsored | 该listing是否为赞助广告 |
| outOfStock | 商品是否缺货 |
| freeShipping | 是否支持免运费 |
| twoDayShipping | 是否支持两日达 |
| freeShippingWithWalmartPlus | Walmart Plus会员是否可享免运费 |
| shippingPrice | 运费 |
| multipleOptionsAvailable | 商品是否有多款变体 |
| variantSwatches | 变体选项列表，包含名称和图片 |
Usage Examples
使用示例
1. Basic keyword search
Search for products matching a keyword:
json
{"keyword": "wireless earbuds"}2. Price-filtered search
Find products within a specific price range:
json
{"keyword": "laptop stand", "minPrice": 10, "maxPrice": 50}3. Best sellers in a category
Browse top-selling products sorted by popularity:
json
{"keyword": "coffee maker", "sort": "best_seller"}4. Budget shopping -- lowest price first
Find the cheapest options for a product:
json
{"keyword": "phone case", "sort": "price_low"}5. Category browsing with pagination
Browse a specific category across multiple pages:
json
{"categoryId": "976759_976787", "page": 2}6. Store-specific inventory check
Search products available at a specific Walmart store:
json
{"keyword": "tent", "storeId": "1862"}7. Mobile results simulation
See results as they appear on mobile devices:
json
{"keyword": "water bottle", "device": "mobile"}8. Combined filters
Apply multiple filters for precise results:
json
{"keyword": "running shoes", "minPrice": 30, "maxPrice": 80, "sort": "best_match"}1. 基础关键词搜索
搜索匹配关键词的商品：
json
{"keyword": "wireless earbuds"}2. 价格筛选搜索
查找特定价格区间内的商品：
json
{"keyword": "laptop stand", "minPrice": 10, "maxPrice": 50}3. 品类畅销商品
按人气排序浏览热销商品：
json
{"keyword": "coffee maker", "sort": "best_seller"}4. 预算购物——低价优先
查找商品的最便宜选项：
json
{"keyword": "phone case", "sort": "price_low"}5. 品类浏览与分页
跨多页浏览特定品类：
json
{"categoryId": "976759_976787", "page": 2}6. 特定门店库存查询
搜索特定沃尔玛门店有售的商品：
json
{"keyword": "tent", "storeId": "1862"}7. 移动端结果模拟
查看移动端展示的搜索结果：
json
{"keyword": "water bottle", "device": "mobile"}8. 组合筛选
应用多个筛选条件获取精准结果：
json
{"keyword": "running shoes", "minPrice": 30, "maxPrice": 80, "sort": "best_match"}Display Rules
展示规则
- Present data clearly: Show search results in well-structured tables with key fields (title, price, rating, reviews, seller). Do not add subjective buying recommendations unless the user asks for analysis.
- Price formatting: Always display prices with the currency symbol. When is present, show both current and original prices to highlight discounts.
wasPrice - Rating context: Display ratings alongside review counts so users can judge credibility (e.g., "4.5 stars from 1,230 reviews").
- Stock status: Clearly flag out-of-stock items so users do not overlook availability issues.
- Sponsored labeling: Mark sponsored products so users can distinguish organic from paid placements.
- Pagination guidance: When results have a large total count, inform the user of the total and suggest paginating with the parameter to see more.
page - Error handling: When a query fails, explain the error clearly and suggest adjusting parameters (e.g., broadening the keyword, changing filters).
- Product links: When showing results, include so users can navigate directly to the Walmart product page.
productPageUrl
- 清晰呈现数据：将搜索结果以结构清晰的表格展示，包含核心字段（标题、价格、评分、评论数、卖家）。除非用户要求分析，否则不要添加主观购买建议。
- 价格格式：始终显示带有货币符号的价格。若存在，需同时展示当前价格和原价以突出折扣。
wasPrice - 评分上下文：将评分与评论数一同展示，方便用户判断可信度（例如：“4.5星，来自1230条评论”）。
- 库存状态：清晰标记缺货商品，避免用户忽略库存问题。
- 赞助标识：标记赞助商品，帮助用户区分自然结果与付费推广内容。
- 分页指引：当结果总数较多时，告知用户总数并建议使用参数分页查看更多内容。
page - 错误处理：当查询失败时，清晰解释错误原因并建议调整参数（例如：放宽关键词、修改筛选条件）。
- 商品链接：展示结果时需包含，方便用户直接跳转至沃尔玛商品详情页。
productPageUrl
User Expression & Scenario Quick Reference
用户表述与场景速查
Applicable -- Walmart product listing queries:
| User Says | Scenario |
|---|---|
| "Search Walmart for XX" | Keyword search |
| "Find cheap XX on Walmart" | Price-filtered search |
| "What's the best-selling XX on Walmart" | Best-seller sort |
| "Compare prices for XX on Walmart" | Price comparison |
| "Is XX in stock at Walmart" | Availability check |
| "Show me Walmart products under $50" | Price-range browse |
| "What are the top-rated XX on Walmart" | Rating-based filtering |
| "Walmart competitor products for XX" | Competitive research |
Not applicable -- Needs beyond Walmart product listings:
- Walmart seller account management or advertising
- Walmart order tracking or purchase history
- Product reviews text analysis (only rating/count is available)
- Historical price tracking or price trend analysis
- Walmart affiliate or API key management
Boundary judgment: When users say "product research" or "competitor analysis" in the context of Walmart, if their need involves searching for current product listings, prices, ratings, or seller information, then this skill applies. If they are asking about advertising strategy, account metrics, or historical sales data, it does not apply.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in . Do not interrupt the user's flow.
references/api.mdFor more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.
适用场景——沃尔玛商品listing相关查询：
| 用户表述 | 场景 |
|---|---|
| “在Walmart上搜索XX” | 关键词搜索 |
| “在Walmart上找便宜的XX” | 价格筛选搜索 |
| “Walmart上最畅销的XX是什么” | 畅销排序 |
| “在Walmart上对比XX的价格” | 价格对比 |
| “XX在Walmart有货吗” | 库存状态查询 |
| “展示Walmart上50美元以下的商品” | 价格区间浏览 |
| “Walmart上评分最高的XX有哪些” | 基于评分的筛选 |
| “XX在Walmart的竞品商品” | 竞品调研 |
不适用场景——超出沃尔玛商品listing的需求：
- Walmart卖家账户管理或广告投放
- Walmart订单追踪或购买历史
- 商品评论文本分析（仅提供评分/评论数）
- 历史价格追踪或价格趋势分析
- Walmart联盟或API密钥管理
边界判断：当用户在Walmart场景下提及“产品调研”或“竞品分析”时，若需求涉及搜索当前商品listing、价格、评分或卖家信息，则适用本技能；若询问广告策略、账户指标或历史销售数据，则不适用。
反馈：
当出现以下任一情况时，自动通过Feedback API检测并上报反馈：
- 本技能描述的功能或用途与实际行为不符
- 技能结果与用户意图不匹配
- 用户表达了对本技能的不满或赞扬
- 任何您认为可以改进的内容
按照中的指定方式调用反馈API，请勿打断用户流程。
references/api.md如需更多高质量、专业的跨境电商技能，请访问LinkFox Skills。