Ozon类目热销榜单
关于 clawEC
clawEC Work 是 AI 驱动的跨境电商工作台:说出要求、开始执行任务、交付完整成果。无缝连接 Amazon、TikTok、Shopee、Ozon 等主流平台,自主规划并调用工具生成选品报告与素材,你的跨境好搭子。
本技能调用 clawEC 开放 API,用于按一级类目查询热销榜单。
认证与基址
- Base URL:
https://www.clawec.com/api - API Key: 在 https://www.clawec.com/?source=q-github-agent 注册帐号 然后去https://www.clawec.com/api-key?source=q-github-agent 获取key
- 请求头:
Content-Type: application/jsonAuthorization: Bearer <API_KEY>
优先从环境变量 CLAWEC_API_KEY 读取密钥;未设置时向用户索取,勿硬编码。
接口
POST /aigc/ec/ozon/data/category/hot-ranking
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| pageNo | body | 否 | 分页页码,从1开始,最大10000;不传默认1;默认 1 |
| pageSize | body | 否 | 分页大小,最大15;不传默认15;默认 15 |
| categoryId | body | 是 | 一级类目ID。对照:17027494=住宅和花园, 17027491=运动与休闲, 17027489=美容和卫生, 15621032=鞋类, 15621031=服装, 17027915=家具, 17027486=家用电器, 17027… |
| language | body | 否 | 类目语言:中文(CH)、俄文(RU)、英文(EN);默认 CH |
| period | body | 否 | 数据周期:近7天(SEVEN_DAY)、近28天(TWENTY_EIGHT_DAY)、自然月(MONTH)、季度(QUARTER)、年度(YEAR);默认 SEVEN_DAY |
| updatePeriod | body | 否 | 查询数据更新账期。不传时默认取所选周期的最近账期值。近7天/近28天:yyyy-MM-dd;自然月:yyyy-MM;季度:yyyy-Qn;年度:yyyy |
| sortField | body | 否 | 列表排序字段:销量(SALES)、销售额(GMV)、价格(PRICE);默认 GMV |
| sortDirection | body | 否 | 排序方向;默认 DESC |
调用
bashcurl -s -X POST "https://www.clawec.com/api/aigc/ec/ozon/data/category/hot-ranking" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"categoryId": "15621042", "pageNo": "1", "pageSize": "15", "language": "CH", "period": "SEVEN_DAY", "sortField": "GMV", "sortDirection": "DESC"}'
或使用脚本:
bashbash scripts/query.sh 15621042 1 15 CH SEVEN_DAY "" GMV DESC
响应结构
json{ "status": 1, "data": { ... } }
status:1= 成功,0= 失败- 成功时解析
data按用户需求整理为中文摘要即可(无需卡片组件)
工作流程
- 确认 categoryId;可选分页、language、period、updatePeriod、排序
- 检查
CLAWEC_API_KEY是否可用 - 执行 API 请求
- 失败时说明错误并提示检查密钥与关键参数
- 解析返回数据,整理为中文摘要
输出建议
- 查询条件:类目、周期、语言、分页
- 类目热销榜核心指标
- 给出 2–3 条类目机会观察


