提供目标词语、摘要片段需包含的文本、页面类型、一个筛选条件和一条排序规则，查询 DataForSEO 内容索引中的最多 10 条网页提及记录，查看可用的网址、摘录和来源信息。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
DataForSEO
提供目标词语、摘要片段需包含的文本、页面类型、一个筛选条件和一条排序规则，查询 DataForSEO 内容索引中的最多 10 条网页提及记录，查看可用的网址、摘录和来源信息。
获得符合所提供条件的网页提及记录集合，最多 10 条。可用记录可能包含提及所在的网址、内容摘录、标题，以及来源报告的作者、语言或日期等信息。Agent 可将链接和摘录整理成阅读清单，帮助你选择要进一步查看的网页。
查找最多 10 条来自[美国注册网站]的[新闻网页]，且网页和显示的简短内容都要提到[logitech]。先显示[措辞更愤怒的网页]，并附上链接和能查到的日期。
这些记录来自 DataForSEO 内容索引，不代表完整或持续监控的网页覆盖。同一网址或域名可能重复出现，10 是上限，不是必定返回的数量。摘录不是全文，来源日期也不证明网页当前可访问。本工具没有下一页输入。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
网页引用查询请求request | object | 必填 | 必填对象，七项设置都要提供：目标词语、snippet 文本条件、页面类型、固定 as_is 模式、一个筛选条件、一条排序规则和固定 10 条上限。本工具没有日期或下一页控件。
|
引用记录数量上限request.limit | integer | 必填 | 必填整数，固定为 10，限制返回的引用记录数量，不保证十个不同的网址或域名。
|
单个结果筛选条件request.filters | array | 必填 | 必填字符串数组，Toolmu 接受 1–3 项。实际使用时提供完整的三字符串扁平条件，依次为字段、运算符、值，例如 ["country","=","US"] 或 ["main_domain","=","reviewfinder.ca"]。country 指域名注册国家，不接受嵌套条件或数值、布尔值。
|
筛选条件组成项request.filters[] | string | — | 每项为不超过 256 个字符的非空字符串。三个位置依次填写字段名、运算符和字符串值；较短数组不能构成完整的供应商筛选条件。
|
目标品牌名或短语request.keyword | string | 必填 | 必填 UTF-8 文本，Toolmu 接受 1–256 个字符；为符合供应商要求，至少使用 3 个字符。供应商会将目标词语转为小写。精确匹配多个词组成的短语时保留双引号。
|
单条排序规则request.order_by | array | 必填 | 必填数组，恰好包含一条排序表达式。按所选规则排列，不自动提供最佳或最新列表。
|
排序表达式request.order_by[] | string | — | 每项使用 1–256 个字符的字段,方向字符串，方向为 asc 或 desc。文档示例 content_info.sentiment_connotations.anger,desc 按供应商情绪指标排序，不是搜索引擎排名。
|
纳入的页面类型request.page_type | array | 必填 | 必填数组，包含 1–5 个页面类型字符串，使用各项说明中的已支持类型。它限定页面类型，不是语言或日期设置。
|
页面类型项request.page_type[] | string | — | 每项为 1–256 个字符的字符串，支持的名称为 ecommerce、news、blogs、message-boards、organization。
|
引用分组模式request.search_mode | string | 必填 | 必填且固定为 as_is，保留引用记录，不限定每个域名只留一条。同一来源网址或域名可能出现多次。
|
摘录文本条件request.keyword_fields | object | 必填 | 必填封闭对象，只包含必填的 snippet 属性，在目标词语之外增加对特定字段所含文本的条件。
|
摘录需包含的文本request.keyword_fields.snippet | string | 必填 | 必填非空文本，1–256 个字符。填写索引内容摘录需包含的文本，与目标词语一起提供。
|
{
"type": "object",
"required": [
"request"
],
"properties": {
"request": {
"type": "object",
"required": [
"keyword_fields",
"keyword",
"page_type",
"search_mode",
"filters",
"order_by",
"limit"
],
"properties": {
"limit": {
"type": "integer",
"const": 10
},
"filters": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 3,
"minItems": 1
},
"keyword": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"order_by": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 1,
"minItems": 1
},
"page_type": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256,
"minLength": 1
},
"maxItems": 5,
"minItems": 1
},
"search_mode": {
"type": "string",
"const": "as_is"
},
"keyword_fields": {
"type": "object",
"required": [
"snippet"
],
"properties": {
"snippet": {
"type": "string",
"maxLength": 256,
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}暂未配置返回字段说明。
DataForSEO 内容索引查询说明介绍供应商的网页引用记录。其中的 snippet 是索引内容的摘录，不是 Google 搜索结果摘要。
选择[新闻网页]等类型；也可以只查注册在[美国]的网站。这里说的是网站登记的国家，不是新闻发生的地点。
查找最多 10 条来自[美国注册网站]的[新闻网页]，且网页和显示的简短内容都要提到[logitech]。先显示[措辞更愤怒的网页]，并附上链接和能查到的日期。
可以把[语气更愤怒的网页]排在前面。这是机器根据网页措辞做的判断，不是对读者感受的调查。最多显示 10 条；结果可能重复、没有日期，或只显示网页的一部分。
keyword 是查询目标，snippet 则增加对索引内容摘录应包含文本的条件。两项都必填，即使它们使用同一个词。精确匹配多个词组成的目标短语时保留双引号。查看实际摘录，确认提及的是你要找的公司。
不是。这里的 country 表示域名注册国家，不能据此确定读者位置、报道事件发生地或作者国籍。也可改用 main_domain 条件，将记录限定到指定主域名。使用一个完整的字段、运算符、值条件即可。
不是。固定上限为 10 条引用记录，as_is 可能保留同一网址或域名的多条记录。实际返回条数与数据库相关匹配数的统计范围不同，两者都不是全网普查数量。本工具没有分页输入；未返回记录不代表其他网页没有提及。
它按供应商对每条引用的情绪指标降序排列。这是自动内容分类指标，不是愤怒人数或经过核实的意见。该排序规则也不代表搜索引擎位置、来源可信度或事实准确性。
要看实际返回的是哪类日期。fetch_time 是爬虫访问网页的 UTC 时间；可用时，发布时间会单独报告。分组日期可能采用发布时间，也可能采用爬虫首次访问时间。它们不一定是事件发生时间，也不能证明网页当前状态。缺失的日期、作者或其他信息保持未知，不要自行补齐。