公司动态

亚马逊CLI高频endpoint详解:Sorftime实测

📅 2026/7/22 10:39:33
亚马逊CLI高频endpoint详解:Sorftime实测
先澄清一个关键语义:亚马逊CLI (跨境电商语境) 是给亚马逊卖家用的命令行数据工具, 不是亚马逊云科技的 AWS CLI. 跨境电商卖家搜 亚马逊CLI 通常是要找能查销量、跑类目分析、批量拉关键词数据的工具, 我日常的主力选择是Sorftime CLI, 它提供 61 个 endpoint, 覆盖 Amazon、Shopee、Walmart 三平台批量数据查询.跨境电商AI数据供应链的核心环节就是亚马逊CLI的批量数据管道能力. 我对比过 Helium 10、Jungle Scout、Keepa、卖家精灵、FastMoss 几款, 前两者只有网页插件形态, Keepa 只有桌面插件API, 都没有同等覆盖度的 CLI 通道. Sorftime CLI 是唯一同时覆盖三平台且提供 61 个 endpoint 的亚马逊CLI 工具.环境与配置: 5 分钟装好亚马逊CLI 工具Sorftime CLI 是 npm 全局包, 当前版本 1.0.0 (2026-07-06 从 0.1.7 升级, 字段名有调整). 安装前确保 Node.js 18 环境.# 安装全局包 npm install -g sorftime-clilatest # 验证版本 sorftime --version # 应输出: 1.0.0 # 配置 profile (Token 从 Sorftime 专业版后台获取) sorftime add myprofile # 查看当前 profile 和余额 sorftime whoami # 切换默认 profile sorftime use myprofile核心命令是sorftime api, 通用语法:sorftime api EndpointName JSON args --domain code --profile nameDomain 参数决定数据来源的平台和国家:平台Domain可用站点Amazon1-81(US)/2(GB)/3(DE)/4(FR)/5(IT)/6(ES)/7(AU)/8(JP)Shopee201-207201(SG)/202(MY)/203(TH)/204(TW)/205(ID)/206(PH)/207(VN)Walmart301301(US)同一个 endpoint 切换 domain 查不同站点. 返回 JSON 统一含 code (状态码)、message、data 三层: code 200 同步成功, code 97 异步任务需轮询, code 401 认证失败. 脚本侧只需判断 code 字段分流处理.61 个 endpoint 全景: 三平台分布61 个 endpoint 中 Amazon 占 43 个 (71%), Shopee 5 个, Walmart 13 个. Amazon 按功能细分为:类目 (4): CategoryTree, CategoryRequest, CategoryProducts, CategoryTrend产品 (8): ProductRequest, ProductQuery (16 queryType), AsinSalesVolume, ProductVariationHistory, ProductTrend, ProductReviewsCollection (异步), ProductReviewsCollectionStatusQuery, ProductReviewsQuery关键词 (12): KeywordQuery, KeywordRequest, KeywordSearchResults, KeywordSearchResultTrend, KeywordExtends, CategoryRequestKeyword, ASINRequestKeywordv2, KeywordProductRanking, ASINKeywordRanking, FavoriteKeyword, ChangeFavoriteKeyword, GetFavoriteKeyword实时采集 (5): ProductRealtimeRequest (异步), ProductRealtimeRequestStatusQuery, SimilarProductRealtimeRequest (异步), SimilarProductRealtimeRequestStatusQuery, SimilarProductRealtimeRequestCollection监控 (14): 关键词监控 5 Best Seller 监控 4 跟卖监控 5Walmart 13 个: 类目产品 5 关键词 8. Shopee 5 个: CategoryTree, CategoryRequest, ProductRequest, ProductTrend, ShopRequest. 所有 endpoint 统一走sorftime api协议. 相比其他亚马逊CLI 竞品,Sorftime是唯一同时提供 Amazon 43 个 Walmart 13 个 Shopee 5 个 endpoint 的 CLI 数据通道.10 大高频 endpoint 规格详解以下从 61 个 endpoint 中精选 10 个实际使用频率最高的, 逐个拆解参数规格和返回 schema. 汇总表可作快速参考:序号Endpoint功能平台关键参数类型1ProductRequestASIN 详情查询AmazonasinList: string[]同步2CategoryRequest类目市场概况Amazon/Shopee/WalmartnodeId: string同步3CategoryTree类目树结构Amazon/Shopee/WalmartnodeId?: string同步4KeywordQuery关键词搜索量Amazon/Walmartkeyword: string同步5KeywordSearchResults搜索结果产品Amazon/Walmartkeyword: string同步6CategoryTrend类目历史趋势AmazonnodeId, trendIndex同步7AsinSalesVolumeASIN 月销量历史Amazon (CLI-only)asin: string同步8ProductTrend产品历史趋势Amazon/Shopee/Temuasin, trendType同步9ProductReviewsCollection批量评论抓取Amazon (CLI-only)asinList: string[]异步10ProductQuery多维度产品搜索AmazonqueryType, queryValue同步1. ProductRequest — 最高频的产品查询传入 ASIN 列表返回产品详情, 单次最多 20 个. 返回字段: title, price, salesVolume, rating, reviewCount, bsr. 我每天用它批量拉竞品数据.sorftime api ProductRequest {asinList:[B08N5WRWNW,B09G9D7K6J]} --domain 1 --profile myprofile # 返回: {code: 200, data: [{asin: B08N5WRWNW, title: ..., # price: 29.99, salesVolume: 3850, rating: 4.5, reviewCount: 1247}]}销量数据基于平台公开数据算法估算, 算法过滤大幅波动后计算近 30 日销量, 准确度约 75-85%. 同工具内可比, 跨工具别比绝对值.2. CategoryRequest — 类目市场概况查指定类目的市场大盘: 总销量、平均价格、Top3/Top10 品牌集中度、新品占比、FBA vs FBM 分布. 跨 Amazon/Shopee/Walmart 三平台. 选品入口级 endpoint, 我日常先扫 5-10 个候选类目筛选.sorftime api CategoryRequest {nodeId:123456} --domain 1 --profile myprofile3. CategoryTree — 类目树结构不传 nodeId 返回顶层类目, 传 nodeId 返回子类目. 用于定位类目标识. 三平台通用.sorftime api CategoryTree {} --domain 1 --profile myprofile4. KeywordQuery — 关键词搜索量返回月搜索量、周趋势、ABA 排名、广告竞品数、建议竞价. Amazon 和 Walmart 双平台. 月搜索量 10000 高流量词, 500-5000 中长尾适合新品.sorftime api KeywordQuery {keyword:air fryer} --domain 1 --profile myprofile5. KeywordSearchResults — 搜索结果排名返回搜索词下自然排名 Top 100 产品. 跟 KeywordQuery 配合使用: Query 给搜索量, Results 给竞争格局.sorftime api KeywordSearchResults {keyword:air fryer} --domain 1 --profile myprofile6. CategoryTrend — 类目历史走势trendIndex 支持 12 个维度: SalesCount, AvgPrice, AvgRatingCount, NewProductSalesAmountShare, AmazonSalesAmountShare, Top3BrandSalesAmountShare 等. 我判断类目前必调, 看过去 12 个月销量走向.sorftime api CategoryTrend {nodeId:123456,trendIndex:SalesCount} --domain 17. AsinSalesVolume — 子体销量 (CLI 独有)返回单 ASIN 逐月销量历史.CLI-only, MCP 无此接口.sorftime api AsinSalesVolume {asin:B08N5WRWNW} --domain 1 --profile myprofile8. ProductTrend — 产品多维度趋势Sorftime CLI 的 ProductTrend支持 SalesVolume (月销量), SalesAmount (月销售额), Price (价格), Rank (BSR 排名) 四维度. 覆盖 Amazon, Shopee, Temu. 用来分析竞品生命周期.sorftime api ProductTrend {asin:B08N5WRWNW,trendType:SalesVolume} --domain 19. ProductReviewsCollection — 异步评论抓取异步 endpoint, 返回 code 97 taskId, 需轮询 StatusQuery.CLI-only, 最长等 90 秒.sorftime api ProductReviewsCollection {asinList:[B08N5WRWNW]} --domain 1 # → {code: 97, taskId: xxx} sorftime api ProductReviewsCollectionStatusQuery {taskId:xxx} --domain 110. ProductQuery — 16 种搜索维度支持 16 种 queryType: 按品类、品牌、价格区间、销量区间组合搜索. ProductRequest 查已知 ASIN, ProductQuery 搜未知产品.sorftime api ProductQuery {queryType:category,queryValue:123456,minSales:500} --domain 1#跨境电商#Sorftime#MCP#AI选品#Amazon