早上 9 点,你打开 Seller Center,一个个点开订单,再导报表,再对库存——每天重复一遍。
我实测接了一遍沃尔玛 API:一个 token 只有 15 分钟有效期。
过期了,就得重新换。
以前接 API 是程序员的活,要写代码、搭服务器、管 token 过期。
现在 AI 帮你跑调用、读报错、把数据写成人话。
这是阿飞出海日记的一篇实测:沃尔玛 API 怎么接,接上之后能干什么。
API 接上 AI,到底能替卖家省下哪些重复活?
01 接入之前,先说一句实话
沃尔玛的 API 是给卖家开的,不是随便注册就能拿。你得先有一个审核通过的卖家账号,凭证是挂在卖家账号上的。
而且 API 分两条线,别搞混了。
第一条是 Marketplace API,卖家自己就能开。订单、库存、商品、价格、报表、WFS,都走这条线。今天实测的就是这条。
第二条是广告 API,只对 Walmart Connect 的合作伙伴开放。个人广告主一般拿不到直接凭证,得走合作伙伴授权,或者在 Ad Center 里看有没有接入权限。没有权限的话,广告数据还是得导报表 CSV。
还有一句实话:Marketplace API 的认证要两个凭证(Client ID + Client Secret)去换 token,而 AI 助手一次只能存一个密钥。所以它接不上那种“一劳永逸”的连接——我是拿自己的凭证临时验证的,验证完就扔,下次用要重新给。先把这句说在前面,免得你照着做,发现跟想象的不一样。
02 接入分三步:拿凭证、换 token、调接口
第一步,拿凭证。
登录 Seller Center,进 API Integration,再进 API Key Management,找到带锁图标的个人密钥对,复制 Client ID 和 Client Secret。
这两个就是你的钥匙。别发聊天记录,别写进代码里,丢了就去同一页轮换一对新的。
Seller Center 里找 Client ID 和 Client Secret 的位置。图源:Walmart 开发者文档
第二步,换 token。
沃尔玛用的是 OAuth 2.0 的 client credentials 方式:拿上面那对凭证,去换一个短期的 token。
curl --request POST \ --url https://marketplace.walmartapis.com/v3/token \ --header 'Authorization: Basic base64(Client ID:Client Secret)' \ --header 'Accept: application/json' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data 'grant_type=client_credentials'
返回的 access_token 只有 15 分钟有效期(900 秒)。过期了就再换一个,不用走什么刷新流程,直接重新换就行。
换 token 的接口说明,返回的 token 有效期 900 秒。图源:Walmart 开发者文档
第三步,调接口。
每次调接口,除了 token,还要带三个头:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
新手最容易错的地方:token 不放在标准的 Authorization 头里,一定要放在 WM_SEC.ACCESS_TOKEN 这个头里,放错了就报 401。
想先练手的话,有沙箱地址:sandbox.walmartapis.com,先在沙箱跑通了再动真格。
03 接上之后,能干什么
接上不是目的,能调什么接口才是。
订单,随时查。GET /v3/orders,能按状态查——新建、已确认、已发货、已送达、已取消,也能按 SKU、按时间段查。不用再进后台一页页翻。
商品,能查能改。GET /v3/items 查你店里的 Listing。上架走 feed 提交:产品已经在沃尔玛目录里的,走 MP_ITEM_MATCH 匹配上架,给 SKU、价格、重量就能上,不用自己写内容;全新的产品走 MP_ITEM 全量上架。改价格、改库存也是 feed 或者单独的接口,一次提交最多 1 万条。
上架常用的几种 feed 类型。图源:Walmart 开发者文档
库存,按 SKU 查。GET /v3/inventory?sku=xxx。注意这个接口必须带 SKU,空着调会直接报错——我是亲测踩过这个坑的。
报表,按需拉。On Request Reports,销售、库存、费用这些报表可以按需生成,一般 15–45 分钟出结果,保留 30 天。
WFS,也能走 API。库存查询、入仓计划这些,都有对应的接口。
广告数据,得看权限。关键词、商品、活动的表现可以自动拉,但前提是有广告 API 的权限。权限不通,就还是导 CSV 那条路,别硬等。
04 接上 Muse,能做到什么
API 是路,Muse 是跑在路上的人。接上之后,你不用再自己翻 Seller Center,也不用自己拼表格,问一句就行。
问一句,就能查。“昨天出了几单?”“哪个 SKU 快没货了?”“这个月广告花了多少?”Muse 帮你调对应的接口,读回结果,再说成人话。今天这篇文章的实测就是这么走的:换 token、查订单、查商品、查库存,全程不用你碰代码。
报表丢给它,结论算出来。On Request Reports 拉下来的 CSV,或者广告后台导出的报表,丢给 Muse,它能算 ROAS、找花钱没单的词、按产品分层,还能把结果做成一个在线工具,上传报表就能看。下面这个工具就是这么做出来的。
用 Muse 做的沃尔玛广告分析工具,上传报表就能算出结果。
上传之后就是这样:总览页直接给花费、销售额、ROAS 和每日趋势;关键词页把赚钱的词和只花钱没单的词分开标出来。下面两张都是演示数据截图,不是真实业绩。
示例数据演示:上传报表后自动算出的总览。演示数据,非真实业绩。
示例数据演示:关键词页,烧钱的词会标上“0 出单”。演示数据,非真实业绩。
上架的 feed,它帮你写。MP_ITEM_MATCH 还是 MP_ITEM,字段填什么、格式长什么样,Muse 帮你把 JSON 拼好、检查一遍,错的地方标出来。你确认了,再提交。
它盯着,你只管点头。库存低于安全线、价格被改了、某个词突然烧钱,Muse 发现了就提醒你。每天早上那份晨报,也是它按下一节的时间表跑出来的。
只有一条线不能越:查可以随便查,写一定要你点头。上架、改价、改库存,每一次写操作都要你先确认;凭证每次都要你重新给,Muse 不存你的 Client Secret。
05 每天自动跑的 4 件活
API 接上之后,真正值钱的是把它变成每天、每周、每月自动跑的固定动作:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
插一句提醒:一个卖家账号一套凭证,自动化跑起来之前,先确认凭证对应的是哪个店。拿错了,每天早上给你报的就是另一个店的数,报得再准也没用。
06 AI 时代,卖家的新分工
以前接 API 是程序员的活:写代码、搭服务器、处理 token 过期、看报错日志。
现在分工变了:
AI 跑腿。写调用、换 token、读报错、把一堆数据整理成一段人话。token 15 分钟过期这种事,程序自动换就行,不用你盯着。
人决策。补多少货、调不调价、广告开不开,这些还是你定。AI 只负责把情况报清楚,不替你拍板。
写操作要人点头。上架、改价、改库存这些动店铺的操作,每次都要你确认了再动。这是底线,AI 不能自己替你改店里的数据。
凭证安全也一样:Client Secret 别发聊天记录,别写进代码。临时用一次,用完就扔;觉得不放心,去 Seller Center 轮换一对新的就行。
AI 时代卖家的竞争力,不是谁更会熬夜看后台,是谁先把重复活交给机器,自己留出时间做判断。
07 想上手,先做这三件事
1确认你要接的是哪个店
一个卖家账号一套凭证,别拿错了,先确认这套凭证对应的是哪个店。
2先拿沙箱练一次只读调用
去 Seller Center 开凭证,查订单、查商品,通了再动真的。
3先定一个最小的周期任务
比如每天早上只报订单和库存,跑顺了,再加广告和复盘。
不用一次全接上,先让每天早上那段话跑起来。
08 注册 Muse,要准备什么
前面说的这些,前提是你已经有了 Muse。还没有的,按我实测过的路子走,准备三样东西就够了。
一个 Gmail 邮箱。能正常登录、能收到登录提醒的 gmail.com 邮箱就行。注册、验证、登录,全靠它。
一个平时在用的 Instagram 账号。注册到年龄验证那一步,用 Instagram 做成年人审核。我就是用平时在用的 Instagram,一次就过了。别用临时账号,别用信息不全的账号。Instagram 不行的话,Facebook 也能做年龄验证,是备选,不是强制。
不用准备 Visa 卡。我全程没用到卡。走到哪一步,就按页面提示走,别自己提前去找卡。
流程就四步:打开 muse.ai,用 Gmail 注册 → 跳转 Instagram 做成年人审核 → 回到 Muse,看到“结账出错了”别慌,年龄已经验证通过了,点“重试”就能过去 → 看完须知事项,点“开始”,进去就显示“已连接”。
详细版带截图的教程,我之前写过一篇,标题是《不用 Visa 卡,我用 Gmail + Instagram 就注册上了 Muse》,在阿飞出海日记里能找到。
结尾
API 不是目的。
目的是把每天重复点的那几十下,变成早上睁眼就能看的一段话。订单、库存、广告,机器每天自动跑一遍,你只需要在关键的地方做决定。
这才是 AI 时代卖家该有的样子。

