手工选品的上限是你愿意翻多少页。用接口的意义不是"更准",而是同一套筛选条件可以每周重跑一次,结果可比,条件可审。
这篇给出一条三步流程。鉴权和密钥管理见鉴权文档,密钥请保存在服务端。
export ECOMMERCE_DATA_API_KEY="your_api_key"第 1 步:先确定值得进的类目
从类目规模入手,而不是从某个商品入手。市场研究 按类目节点路径和月均销量区间筛细分市场:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/market/research \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"month": "202507",
"nodeIdPath": "172282:281407",
"minAvgUnits": 100,
"maxAvgUnits": 10000,
"page": 1
}'minAvgUnits / maxAvgUnits 是这一步的关键。下限排掉没需求的细分,上限排掉已经被大牌占满的大盘。中间那一段才是可进入的区间,具体数值要按你自己的资金和物流条件定。
拿到候选类目后,用 品牌集中度 和 卖家集中度 做一次淘汰:头部品牌占比过高的类目,选品阶段就可以放弃。
第 2 步:在类目里筛商品
商品研究 是这条流程里最重的一步,条件最多:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/research \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"month": "nearly",
"keyword": "bath rug",
"matchType": 2,
"minPrice": 20,
"maxPrice": 80
}'三组条件的实际作用不一样:
- 价格区间 — 决定你的成本结构能不能打,卡得最狠。
- 评分与评论数 — 评论数少而评分不低,通常意味着这个位置还没被口碑锁死。
- 卖家数 — 单个 ASIN 上卖家过多说明是跟卖红海,配送方式一并看。
完整参数清单在接口文档里,month 支持 nearly 取最近周期,方便定时任务不用每次改月份。
第 3 步:给候选排量级
候选清单出来之后需要排序。BSR 销量估算 只要 BSR 和类目 ID,适合对几十上百个 ASIN 批量调用:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/sales/prediction/bsr \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"bsr": 1,
"categoryId": "Category ID"
}'对单个重点 ASIN 想要更细的判断,用 商品销量估算。两者都是估算值。
做成定时任务时要注意的三件事
一、限流按账号算。 RPM 和并发是账号维度的,多建密钥不会提高额度。批量调第 3 步时要自己控制并发,遇到 429 按 Retry-After 退避,见错误与限流。
二、只对成功的计费请求计费。 返回结果前就失败的请求不计费,所以重试是安全的,但循环写错会很快烧掉调用次数——先用 "size": 1 把流程跑通再放开分页。
三、固定口径。 把 marketplace 和 month 写进任务配置而不是散落在代码里。跨周期对比时,口径不一致是最常见的错误来源。
字段怎么读
| 字段类型 | 例子 | 怎么用 |
|---|---|---|
| 平台可见 | 价格、评分、评论数、卖家数 | 当前快照,可核对,可直接用 |
| 第三方估算 | 月销量、营收、需求量级 | 只做排序和量级判断,不做财务预测 |
| 结构指标 | 品牌集中度、价格带分布 | 回答"能不能进",不回答"能赚多少" |
限制
- 销量和营收是估算值,会随时间修正,同一 ASIN 隔周再查可能不同。
- 类目节点路径各站点不同,跨站点复用同一套
nodeIdPath会出错。 - 这条流程不覆盖采购成本、头程物流、认证合规——它只回答"市场层面值不值得"。
不想写代码可以把同一条流程交给 Agent,见把选品交给 AI Agent。下一步给候选品搭词库,见搭建自己的关键词库。