Google 搜索意图（实时）

接口说明

通过本接口可一次性获取最多 1,000 个的搜索意图数据。对于请求中提交的每个，接口会返回：

• 该最可能的搜索意图
• 对应的意图概率
• 可能的搜索意图及概率

系统基于数据与搜索结果数据训练，可识别以下 4 类搜索意图：

• informational：信息型
• navigational：导航型
• commercial：商业调研型
• transactional：交易型

请求地址

POST https://api.seermartech.cn/v3/dataforseo_labs/google/search_intent/live

计费说明

本接口按请求计费。

参考价约 ¥0.0224 / 次 扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

调用限制

• 每分钟最多可发送 2000 次 API 调用
• 同时并发请求上限为 30
• POST 数据须使用 JSON（UTF-8 编码）
• 请求体格式为 JSON 数组：[{ ... }]

---

请求参数

字段名	类型	说明
keywords	array	目标数组。填。UTF-8 编码；数组中最多可传 1000 个；提交后会自动转换为小写。
language_name	string	语言名。未传 language_code 时填。可通过 /v3/dataforseo_labs/locations_and_languages 查询可用语言。示例：English
language_code	string	语言代码。未传 language_name 时填。可通过 /v3/dataforseo_labs/locations_and_languages 查询可用语言。示例：en
tag	string	自定义任务标识。可选；最长 255 个字符。可用于请求与响应结果的对应，返回时会出现在响应的 data 对象中。

语言支持说明

当前接口支持以下语言：

语言	代码
Arabic	ar
Chinese(Traditional)	zh-TW
Czech	cs
Danish	da
Dutch	nl
English	en
Finnish	fi
French	fr
German	de
Hebrew	he
Hindi	hi
Italian	it
Japanese	ja
Korean	ko
Malay	ms
Norwegian(Bokmål)	nb
Polish	pl
Portuguese	pt
Romanian	ro
Russian	ru
Spanish	es
Swedish	sv
Thai	th
Ukrainian	uk
Vietnamese	vi
Bulgarian	bg
Croatian	hr
Serbian	sr
Slovenian	sl
Bosnian	bs
Greek	el
Hungarian	hu
Slovak	sk
Turkish	tr

---

返回结果

接口返回 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
items_count	integer	items 数组中的结果数量
items	array	搜索意图结果列表

items 数组字段

字段名	类型	说明
keyword	string	请求中的目标
keyword_intent	object	当前最主要的搜索意图
keyword_intent.label	string	搜索意图名称，可选值：informational、navigational、commercial、transactional
keyword_intent.probability	float	搜索意图概率，1 表示最高概率
secondary_keyword_intents	array	可能的搜索意图列表
secondary_keyword_intents[].label	string	搜索意图名称
secondary_keyword_intents[].probability	float	搜索意图概率

---

请求示例

cURL

curl --location --request POST "https://api.seermartech.cn/v3/dataforseo_labs/google/search_intent/live" \
--header "Authorization: Bearer smt_live_YOUR_KEY" \
--header "Content-Type: application/json" \
--data-raw '[
 {
 "keywords": [
 "login page",
 "audi a7",
 "elon musk",
 "milk store new york"
 ],
 "language_name": "English",
 "tag": "intent-batch-001"
 }
]'

Python

import requests

url = "https://api.seermartech.cn/v3/dataforseo_labs/google/search_intent/live"
headers = {
 "Authorization": "Bearer smt_live_YOUR_KEY",
 "Content-Type": "application/json"
}
payload = [
 {
 "keywords": [
 "login page",
 "audi a7",
 "elon musk",
 "milk store new york"
 ],
 "language_name": "English",
 "tag": "intent-batch-001"
 }
]

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

TypeScript

import axios from "axios";

const payload = [
 {
 keywords: [
 "login page",
 "audi a7",
 "elon musk",
 "milk store new york"
 ],
 language_name: "English",
 tag: "intent-batch-001"
 }
];

axios({
 method: "post",
 url: "https://api.seermartech.cn/v3/dataforseo_labs/google/search_intent/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.response?.data || error.message);
 });

---

响应示例

{
 "version": "0.1.20221214",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1285 sec.",
 "cost": 0.0014,
 "tasks_count": 1,
 "tasks_error": 0,
 "tasks": [
 {
 "id": "00000000-0000-0000-0000-000000000000",
 "status_code": 20000,
 "status_message": "Ok.",
 "time": "0.1200 sec.",
 "cost": 0.0014,
 "result_count": 1,
 "path": [
 "v3",
 "dataforseo_labs",
 "google",
 "search_intent",
 "live"
 ],
 "data": {
 "api": "dataforseo_labs",
 "function": "search_intent",
 "se_type": "google",
 "language_code": "en",
 "keywords": [
 "login page",
 "audi a7",
 "elon musk",
 "milk store new york"
 ],
 "tag": "intent-batch-001"
 },
 "result": [
 {
 "language_code": "en",
 "items_count": 4,
 "items": [
 {
 "keyword": "login page",
 "keyword_intent": {
 "label": "navigational",
 "probability": 1
 },
 "secondary_keyword_intents": [
 {
 "label": "informational",
 "probability": 0.21
 }
 ]
 },
 {
 "keyword": "audi a7",
 "keyword_intent": {
 "label": "commercial",
 "probability": 1
 },
 "secondary_keyword_intents": [
 {
 "label": "transactional",
 "probability": 0.46
 },
 {
 "label": "informational",
 "probability": 0.28
 }
 ]
 },
 {
 "keyword": "elon musk",
 "keyword_intent": {
 "label": "informational",
 "probability": 1
 },
 "secondary_keyword_intents": [
 {
 "label": "navigational",
 "probability": 0.19
 }
 ]
 },
 {
 "keyword": "milk store new york",
 "keyword_intent": {
 "label": "transactional",
 "probability": 1
 },
 "secondary_keyword_intents": [
 {
 "label": "commercial",
 "probability": 0.37
 }
 ]
 }
 ]
 }
 ]
 }
 ]
}

---

状态码与错误处理

建议接时同时处理顶层状态码和任务级状态码：

• 顶层 status_code：表示整个请求的处理状态
• tasks[].status_code：表示单个任务的执行状态

常见成功状态：

• 20000：请求成功

完整错误码与状态说明请参考 /v3/appendix/errors。 建议对以下建立异常处理机制：

• 鉴权失败
• 参数缺失或格式错误 -出并发或频率限制
• 任务级部分成功、部分失败
• 返回结果为空或 language_code 为 null

使用建议

• 批量分析时，建议将同语言放在同一请求中，便于结果归类与后续处理
• 若需稳定追踪业务批次，建议始终传 tag
• 对于规划场景，可重点使用 keyword_intent.label
• 对于更细的优级判断，可结合 secondary_keyword_intents 中的概率分布进行二次分类

实用场景

• 识别类型：判断更偏信息型、导航型、商业型还是交易型，指导团队选择文章页、品牌页或落地页形态。
• 筛选高转化词：优找出 transactional 和 commercial ，用于投放着陆页、商品页和转化型专题页建设。
• 优化分组：根据搜索意图对大批量聚类，减少不同意图混排带来的页面性问题。
• 校验页面目标是否匹：将现有页面承接的与返回意图比对，发现“信息型词落到交易页”等错问题。
• 制定 SEO优级：结合主意图与次级意图概率，判断处于认知、比较还是转化阶段，优化选题和转化路径设计。