分类识别

POST /v3/dataforseo_labs/google/categories_for_keywords/live

接口说明

/v3/dataforseo_labs/google/categories_for_keywords/live 用于根据指定返回对应的 Google 商品与服务分类。

你可以在一次请求中最多提交 1000 个。接口会为每个返回分类列表，适合用于意图识别、行业归类、落地页规划等场景。

• 请求方式：POST
• 接口路径：/v3/dataforseo_labs/google/categories_for_keywords/live
• 完整地址：https://api.seermartech.cn/v3/dataforseo_labs/google/categories_for_keywords/live

可用语言列表可通过以下接口获取：

• /v3/dataforseo_labs/google/categories_for_keywords/languages

分类可参考平台提供的分类数据文件。

计费说明

该接口按请求计费。

参考价约 ¥0.0165 / 次。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

• 每分钟最多发起 2000 次 API 调用
• 同时并发请求上限为 30

请求体格式

所有 POST 数据使用 JSON（UTF-8 编码），且请求体为 JSON 数组格式：

[
 {
 "keywords": ["dentist new york", "pizza brooklyn", "car dealer los angeles"],
 "language_name": "English"
 }
]

请求参数

字段名	类型	说明
keywords	array	目标列表。填。使用 UTF-8 编码。数组中最多可传 1000 个。会被自动转换为小写。
language_name	string	语言名。未传 language_code 时填。可通过 /v3/dataforseo_labs/google/categories_for_keywords/languages 获取支持的语言列表。示例：English
language_code	string	语言代码。未传 language_name 时填。可通过 /v3/dataforseo_labs/google/categories_for_keywords/languages 获取支持的语言列表。示例：en
tag	string	自定义任务标识。可选。最大长度 255 个字符。可用于在响应中匹任务与业务记录，返回时会出现在响应的 data 对象中。

响应结构

接口返回 JSON 数据，顶层 tasks 数组。

顶层字段

字段名	类型	说明
version	string	当前 API 版本号
status_code	integer	通用状态码。完整错误码可参考 /v3/appendix/errors
status_message	string	通用状态信息。完整信息可参考 /v3/appendix/errors
time	string	执行耗时，单位秒
cost	float	本次请求总费用，单位 USD
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	返回错误的任务数量
tasks	array	任务结果数组

建议在接时做好异常处理与错误码底逻辑。

tasks 数组字段

字段名	类型	说明
id	string	任务唯一标识，UUID 格式
status_code	integer	任务状态码，范围通常为 10000-60000，完整列表参考 /v3/appendix/errors
status_message	string	任务状态信息
time	string	任务执行耗时，单位秒
cost	float	该任务费用，单位 USD
result_count	integer	result 数组中的结果数量
path	array	URL 路径
data	object	回显请求时提交的参数
result	array	获取结果数组

result 数组字段

字段名	类型	说明
language_code	string	请求中的语言代码；如果无数据则为 null
total_count	integer	数据库中与请求的总结果数
items_count	integer	items 数组返回的结果数量
items	array	及对应分类结果

items 数组字段

字段名	类型	说明
keyword	string	请求中的
categories	array	该对应的商品或服务分类列表

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/google/categories_for_keywords/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "keywords": [
 "dentist new york",
 "pizza brooklyn",
 "car dealer los angeles"
 ],
 "language_name": "English"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/categories_for_keywords/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "keywords": [
 "dentist new york",
 "pizza brooklyn",
 "car dealer los angeles"
 ],
 "language_name": "English"
 }
]

response = requests.post(url, json=payload, headers=headers)
print(response.json)

TypeScript

import axios from "axios";

const payload = [
 {
 keywords: [
 "dentist new york",
 "pizza brooklyn",
 "car dealer los angeles"
 ],
 language_name: "English"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/google/categories_for_keywords/live",
 headers: {
 Authorization: "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
 },
 data: payload
})
 .then((response) => {
 // 输出接口返回结果
 console.log(response.data);
 })
 .catch((error) => {
 console.error(error);
 });

响应示例

{
 "version": "0.1.20240626",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.0969 sec.",
 "cost": 0.00103,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "data": {
 "api": "dataforseo_labs",
 "function": "categories_for_keywords",
 "se_type": "google",
 "language_code": "en",
 "keywords": [
 "dentist new york",
 "pizza brooklyn",
 "car dealer los angeles"
 ]
 },
 "result": [
 {
 "language_code": "en",
 "total_count": 3,
 "items_count": 3,
 "items": [
 {
 "keyword": "dentist new york",
 "categories": [
 "Health > Dental Services"
 ]
 },
 {
 "keyword": "pizza brooklyn",
 "categories": [
 "Food & Beverage > Restaurants > Pizza"
 ]
 },
 {
 "keyword": "car dealer los angeles",
 "categories": [
 "Automotive > Car Dealers"
 ]
 }
 ]
 }
 ]
 }
 ]
}

状态码与错误处理

• 顶层 status_code 表示整次请求处理状态
• tasks[].status_code 表示单个任务的执行状态
• 建议同时校验：
• HTTP 状态码
• 顶层 status_code
• tasks_error 是否为 0
• tasks[].result_count 是否大于 0

常见成功判断方式：

• 顶层 status_code = 20000
• tasks_error = 0

完整错误码与说明可参考 /v3/appendix/errors。

使用说明

1. 在 keywords 中传分类的列表
2. 通过 language_name 或 language_code 指定语言
3. 接口返回每个对应的商品/服务分类
4. 可结合返回分类结果进行分组、专题页策划或行业标签构建

实用场景

• 识别商业归属：把海量搜索词自动映射到商品或服务分类，快速判断属于哪个业务线或行业。
• 构建 SEO 词分组：按分类聚合同类，便于制定栏目页、专题页和落地页结构。
• 筛选高投放词：将广告词或候选词按行业分类洗，减少与主营业务无的流量。
• 搭建行业标签体系：为库批量补标准化分类标签，方便后续做报表、聚类分析和趋势监控。
• 发现覆盖缺口：对现有池进行分类统计，找出尚未布局或覆盖不足的业务主题。