bee-products-read
版本: 2.0.0
简介
通过小蜜蜂（Bee）建站开放 API 获取产品/商品列表数据。
支持按语言筛选、产品分组筛选（叶子节点）、分页查询，并返回完整产品结构数据，可用于商品展示、SEO 优化、数据分析与内容生成。
输入参数
api_key (string, 必填)
API 身份认证密钥，用于标识调用方身份并控制接口访问权限。
- 获取地址: https://open.tradew.com
- 用于 API 权限校验
language (string, 必填)
站点语言筛选参数。
⚠️ 必须从
bee-languages-get返回列表中人工选择，不允许 AI 推断或自动生成。
productsgroup_id (integer, 可选)
产品分组 ID。
⚠️ 仅允许选择
is_leaf === true的叶子节点分组
非叶子节点必须过滤，不可使用
pagination (object, 必填)
分页配置参数。
current_page (integer)
- 默认值: 1
- 最小值: 1
- 分页规则：
- 必须依赖
data.pagination.has_next_page - 使用
data.pagination.next_page作为下一页页码 - 禁止基于
total_page或手动递增推算 has_next_page=false时必须停止请求
- 必须依赖
page_size (integer)
- 默认值: 10
- 范围: 10 - 50
输出结构
顶层结构
| 字段 | 类型 | 说明 |
|---|---|---|
| status | boolean | 请求状态 |
| msg | string | 返回消息 |
| data | object/null | 返回数据 |
data.pagination
| 字段 | 类型 | 说明 |
|---|---|---|
| current_page | integer | 当前页码 |
| page_size | integer | 每页数量 |
| total_page | integer | 总页数 |
| total_count | integer | 总记录数 |
| has_next_page | boolean | 是否存在下一页 |
| next_page | integer/null | 下一页页码 |
data.list[]
产品数据列表。
| 字段 | 类型 | 说明 |
|---|---|---|
| products_id | integer | 产品ID |
| language | string | 站点语言 |
| group | object | 产品分组 |
| product_name | string | 产品名称 |
| model | string | 产品型号 |
| images | array | 产品图片URL列表 |
| tags | array | 关键词 |
| attributes | array | 属性列表 |
| brief_description | string | 简要描述 |
| description | string | 详情描述（HTML） |
| tdk | object | SEO信息 |
| view_count | integer | 访问量 |
| inquiry_count | integer | 询盘量 |
| product_url | string | 详情页URL |
| create_time | string(datetime) | 创建时间 |
| update_time | string(datetime) | 更新时间 |
group
| 字段 | 类型 | 说明 |
|---|---|---|
| productsgroup_id | string | 分组ID |
| group_name | string | 分组名称 |
attributes[]
| 字段 | 类型 | 说明 |
|---|---|---|
| name | string | 属性名 |
| value | string | 属性值 |
tdk
| 字段 | 类型 | 说明 |
|---|---|---|
| title | string | SEO标题（≤70字符） |
| description | string | SEO描述（25-160字符） |
| keywords | string | SEO关键词（≤100字符） |
依赖关系
| 参数 | 依赖技能 | 字段来源 | 模式 |
|---|---|---|---|
| language | bee-languages-get | list[].language | select |
| productsgroup_id | bee-productsgroup-read | list[].productsgroup_id | select（filter: is_leaf=true） |
使用示例
基础查询
{
"api_key": "your-api-key",
"language": "en",
"pagination": {
"current_page": 1,
"page_size": 10
}
}