实时引用内容搜索
/content_analysis_search_live返回目标关键词对应的详细引用数据。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 DataForSEO 的 /content_analysis_search_live 接口。
输入参数
keyword必填- 目标关键词。 必填字段。 UTF-8 编码。 关键词会转换为小写; 注意: 若需匹配精确短语而非单个关键词,请使用双引号和反斜杠; 例如: `"keyword": "\"tesla palo alto\""` 了解以下字段的规则和限制: keyword and keywords 在 DataForSEO API 中的用法,参见此 帮助中心文章
keyword_fields选填- 目标关键词字段及关键词。 可选字段。 按特定字段应包含的关键词筛选数据集。可指定字段: title , main_title , previous_title , snippet 可指定多个字段; 注意: 若需匹配精确短语而非单个关键词,请使用双引号和反斜杠; 例如: `"keyword_fields": { "snippet": "\"logitech mouse\"", "main_title": "sale" }"`
page_type选填- 目标页面类型。 可选字段。 按页面类型筛选数据集。 可用值: "ecommerce" , "news" , "blogs" , "message-boards" , "organization"
search_mode选填- 结果分组类型。 可选字段。 可用分组类型: as_is :返回目标 keyword 的所有引用; one_per_domain :每个域名返回一个 keyword 引用; 默认值: as_is
limit必填- 返回引用数上限。 可选字段。默认值: 100;最大值: 1000
filters选填- 结果筛选参数数组。 可选字段。 可同时添加多个筛选条件(最多 8 个)。 请在条件间设置逻辑运算符 and , or 。支持以下运算符: regex , not_regex , < , <= , > , >= , = , <> , in , not_in , like , not_like , match , not_match 可将 % 运算符与 like、not_like 配合使用,匹配任意零个或多个字符的字符串。 例如: ["country","=", "US"] [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]] [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or", ["content_info.text_category","has",10994]]] 筛选条件详情参见 Content Analysis API 筛选说明
order_by选填- 结果排序规则。 可选字段。可使用 filters 数组中相同的字段值对结果排序。 可用排序类型: asc :按升序排列结果; desc :按降序排列结果; 请使用逗号指定排序类型。 例如: ["content_info.sentiment_connotations.anger,desc"] 默认规则: ["content_info.sentiment_connotations.anger,desc"];注意:单次请求最多设置三条排序规则。 请使用逗号分隔多个排序规则。 例如: ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
offset选填- 返回引用结果数组的偏移量。 可选字段。默认值: 0 指定为 10 时,跳过结果数组的前十个引用,返回后续引用。 注意: 建议仅在获取不超过 10,000 条结果时使用此参数;超过 10,000 条结果请使用 offset_token 。
offset_token选填- 后续请求使用的偏移令牌。 可选字段。 由每次请求响应中的同名字段提供; 单次请求获取超过 10,000 条结果时,可用此参数避免超时; 指定唯一的 offset_token 响应数组中的值,可获取初始任务的后续结果; offset_token 各后续任务的值均唯一。 注意: 请求指定 offset_token 时,处理任务将忽略除 limit 之外的所有其他参数。 此参数详情参见帮助中心。
rank_scale选填- 指定计算及展示以下值所用的量表: domain_rank , 和 url_rank values;可选字段。 可选择以 0–100 或 0–1000 量表展示排名值。 可用值: one_hundred :以 0–100 量表展示排名值; one_thousand :以 0–1000 量表展示排名值; 默认值: one_thousand 此参数工作原理参见 此帮助中心文章
输入示例
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}输出
原生任务结果封装;在支持时包含条目、聚合结果和分页信息。