分类列表

GET /v3/dataforseo_labs/categories

本接口用于获取 本平台 Labs 能力支持的分类列表。分类体系基于 Google 商品与服务分类，可用于行业映射、竞品分组、聚类等场景。

• 请求方式：GET
• 接口地址：https://api.seermartech.cn/v3/dataforseo_labs/categories
• 计费：，不产生调用费用
• 实扣费以响应头 X-SeerMarTech-Charge-CNY 为准

接口返回 JSON 格式数据，顶层 tasks 数组，每个任务中可用分类列表。

请求信息

HTTP 请求

GET /v3/dataforseo_labs/categories

请求头

名称	类型	填	说明
Authorization	string	是	使用 Bearer Token：Bearer smt_live_YOUR_KEY
Content-Type	string	否	建议填写 application/json

说明：该接口为 GET 请求，无需请求体。

响应结构

顶层字段

字段	类型	说明
version	string	当前 API 版本
status_code	integer	接口通用状态码
status_message	string	接口通用信息
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	tasks 数组中返回错误的任务数量
tasks	array	任务数组

完整错误码与状态说明请参考 /v3/appendix/errors

tasks 数组字段

字段	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000
status_message	string	任务状态信息
time	string	当前任务执行耗时，单位秒
cost	float	当前任务费用，单位 USD
result_count	integer	result 数组中的结果条数
path	array	当前请求的 URL 路径
data	object	GET 请求 URL 中传的参数信息
result	array	分类结果列表

result 数组字段

字段	类型	说明
category_code	integer	分类编码
category_name	string	分类完整名称
category_code_parent	integer / null	上级分类编码；顶级分类通常为 null

分类层级示例

{
 "category_code": 10178,
 "category_name": "Apparel Accessories",
 "category_code_parent": 10021
}

上述分类的父级分类对应为：

{
 "category_code": 10021,
 "category_name": "Apparel",
 "category_code_parent": null
}

示例请求

cURL

curl --location --request GET "https://api.seermartech.cn/v3/dataforseo_labs/categories" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json"

Python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/categories"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
result = response.json

if result.get("status_code") == 20000:
 print(result)
else:
 print(f'error. Code: {result.get("status_code")} Message: {result.get("status_message")}')

TypeScript

import axios from "axios";

// 获取分类列表
axios({
 method: "get",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/categories",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "content-type": "application/json",
 },
})
 .then((response) => {
 // 返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.log(error);
 });

示例响应

{
 "version": "0.1.20200305",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0594 sec.",
 "cost": 0,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "categories"
 },
 "result": []
 }
 ]
}

状态与错误说明

通用状态字段

• status_code：接口或任务的状态码
• status_message：对应状态说明
• tasks_error：任务级错误数量

常见成功状态

状态码	含义
20000	请求成功

错误排查建议

• 检查 Authorization 是否为有效的 Bearer Token
• 确认请求地址是否为 /v3/dataforseo_labs/categories
• 查看顶层和任务级 status_code / status_message
• 如需完整错误码说明，请参考 /v3/appendix/errors

使用说明

该接口适合在正式调用行业研究、竞品分析、机会类接口之前，拉取完整分类字并在本地缓存。由于分类存在父子层级，建议在业务侧构建分类树，以便：

• 进行行业归类与筛选
• 将或域名分析结果映射到标准行业分类
• 支持前端分类选择器或筛选面板
• 实现跨项目统一分类口径

实用场景

• 构建行业分类树：拉取分类并建立父子层级结构，便于在后台系统中提供标准化行业选择能力。
• 映射到行业：将研究结果到标准分类，提升专题分析、聚类和报表汇总的一致性。
• 筛选竞品研究范围：在做行业级竞品挖掘前，确定目标分类，缩小分析范围并提升结论性。
• 统一多项目标签体系：将不同客户、站点或库统一映射到同一分类标准，便于横向对比与趋势跟踪。
• 驱动前端筛选器：将分类字用于产品界面的下拉框、树形选择器或过滤条件，提升分析操作效率。