SuperAPI AI 工具集

ecommerce-amazon-keyword-search-history

数据与分析

查看项目

更新于 10-16 06:50

技能介绍

用途:查询 Amazon 关键词的历史精确匹配搜索量,按 7 天一个数据点输出,用于判断季节性、趋势方向、波动性和促销节日效应。

主要能力:返回字段包括周期 ID、周期开始/结束日期、该周精确搜索量与资源类型。支持站点 marketplace 取值:us、uk、de、in、ca、fr、it、es、mx、jp,未指定时默认 us。

使用方式:四个参数均为必填——marketplace、keyword、startDate、endDate,日期格式 YYYY-MM-DD。可调用 API 端点 POST /tool-jungle-scout/keywords/historical-search-volume,或运行脚本 python scripts/amazon_keyword_search_history.py '<JSON params>' [--inline]。脚本默认在工作目录下保存完整响应 JSON,超过 8 KB 时仅输出摘要;可加 --inline 强制完整输出。查询最多跨 366 天,超出需拆分多次请求。

适用场景:查看关键词搜索量历史变化、判断类目季节性、识别旺季时段、对比同一关键词在不同站点的搜索规模、验证需求是否增长。

限制:单次查询最多 366 天;数据粒度为周,不是每日;为精确匹配搜索量,非广泛匹配;不适用于关键词挖掘、实时排名、竞争度、CPC 出价、销量或非 Amazon 平台数据。该工具消耗额度(costToken 记为 1),同一会话与参数组合默认只调用一次并本地缓存 24 小时;失败或空结果时不要自动用不同关键词、分页或邮编重试,继续搜索前须告知用户额外消耗。需设置 NEXSCOPE_API_KEY 环境变量,凭证缺失或过期时前往 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值额度。