bee-productsgroup-read
Version: 2.0.2
Overview
Use the Bee Website Builder Open API to retrieve product group/category data.
Supports language filtering, querying by parent group, and returning multi-level nested structures. It can be widely used in product category display, querying products under groups, product publishing group selection, data analysis, AI content generation, SEO optimization, and intelligent retrieval.
Input Parameters
api_key (string, Required)
API authentication key used to identify the caller and control interface access permissions.
- Get it from: https://open.tradew.com
- Used for API permission validation
language (string, Required)
Site language filter parameter.
⚠️ After user confirmation, it must be selected from the list returned by
bee-languages-get
❌ AI is not allowed to infer or generate it automatically
productsgroup_id (integer, Optional)
Parent product group ID, used to retrieve the child group list.
- If omitted, top-level groups are returned
- If provided, child groups under that group are returned
Output Structure
Top-Level Structure
| Field | Type | Description |
|---|---|---|
| status | boolean | Request status |
| msg | string | Response message |
| data | object/null | Returned data |
data.list[]
Product group list data.
| Field | Type | Description |
|---|---|---|
| productsgroup_id | integer | Product group ID |
| language | string | Site language code |
| group_name | string | Group name |
| tags | array | Keyword list |
| productsgroup_url | string | Group URL |
| create_time | string(datetime) | Creation time |
| update_time | string(datetime) | Update time |
| is_leaf | boolean | Whether it is a leaf node |
| children | array | Child groups (recursive structure) |
children[]
Recursive structure with the same node structure as list[].
Dependencies
| Parameter | Dependency skill | Field source | Mode |
|---|---|---|---|
| language | bee-languages-get | list[].language | select |
Usage Rules
languagemust be obtained throughbee-languages-getproductsgroup_idis used only to retrieve child groupschildrensupports unlimited recursive nesting- The integrity of the tree structure must be preserved
Usage Example
Retrieve Top-Level Groups
{
"api_key": "your-api-key",
"language": "en"
}