BSR类目查询
POST
/api/v2/category/lookup
当 categoryId、level、withChild 三个参数都不填时，返回当前市场的所有根类目ID
level一般情况下可不填，当一个bsr类目有多条路径时，可以通 level 参数来指定要查询的类目的层级，获得更精细的结果
比如 Home & Kitchen -> Kitchen & Dining 与 Kitchen & Dining 是同一个类目ID，但是 Kitchen & Dining既是根类目又在bsr上属于 Home & Kitchen 的子类目，此时可以指定level= 1 来确定是要返回根类目的 Kitchen & Dining
此时查询参数构造为
{
"market": "us",
"categoryId": "284507",
"level": 2
}
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Body 参数application/json必填
示例
{
"market": "us",
"categoryId": "1055398"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://open-api.flyfus.com/api/v2/category/lookup' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"market": "us",
"categoryId": "1055398"
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"data": {
"categoryId": "284507",
"name": "Kitchen & Dining",
"level": 1,
"path": [
{
"categoryId": "284507",
"name": "Kitchen & Dining"
}
],
"child": [
{
"categoryId": "1063916",
"name": "Kitchen & Table Linens"
},
{
"categoryId": "1267449011",
"name": "Small Appliance Parts & Accessories"
},
{
"categoryId": "13162311",
"name": "Dining & Entertaining"
},
{
"categoryId": "13299291",
"name": "Wine Accessories"
},
{
"categoryId": "289668",
"name": "Bakeware"
},
{
"categoryId": "289754",
"name": "Kitchen Utensils & Gadgets"
},
{
"categoryId": "289814",
"name": "Cookware"
},
{
"categoryId": "289851",
"name": "Cutlery & Knife Accessories"
},
{
"categoryId": "289913",
"name": "Small Appliances"
},
{
"categoryId": "510136",
"name": "Storage & Organization"
},
{
"categoryId": "510202",
"name": "Water Coolers & Filters"
},
{
"categoryId": "6054382011",
"name": "Food Service Equipment & Supplies"
},
{
"categoryId": "915194",
"name": "Coffee, Tea & Espresso"
},
{
"categoryId": "9630569011",
"name": "Travel & To-Go Drinkware"
},
{
"categoryId": "979832011",
"name": "Home Brewing & Wine Making"
},
{
"categoryId": "284507",
"name": "Kitchen & Dining"
},
{
"categoryId": "1063916",
"name": "Kitchen & Table Linens"
},
{
"categoryId": "13162311",
"name": "Dining & Entertaining"
},
{
"categoryId": "13217501",
"name": "Glassware & Drinkware"
},
{
"categoryId": "13299291",
"name": "Wine Accessories"
},
{
"categoryId": "289668",
"name": "Bakeware"
},
{
"categoryId": "289728",
"name": "Bar Tools & Drinkware"
},
{
"categoryId": "289742",
"name": "Coffee, Tea & Espresso Appliances"
},
{
"categoryId": "289754",
"name": "Kitchen Utensils & Gadgets"
},
{
"categoryId": "289814",
"name": "Cookware"
},
{
"categoryId": "289851",
"name": "Cutlery & Knife Accessories"
},
{
"categoryId": "289913",
"name": "Small Appliances"
},
{
"categoryId": "510136",
"name": "Storage & Organization"
},
{
"categoryId": "979832011",
"name": "Home Brewing & Wine Making"
}
]
},
"code": 0,
"msg": "success"
}修改于 2026-06-10 07:26:17