相关页面
此端点将提供指定域名下网页的排名和流量数据。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
位置的完整名称。可选字段。如果使用此字段,则无需指定 location_code。您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求,获取包含 location_name 的可用位置列表。忽略此字段可获取所有可用位置的结果。示例:United Kingdom
位置代码,可选字段。如果使用此字段,则无需指定 location_name。您可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发送请求,获取包含 location_code 的可用位置列表。忽略此字段可获取所有可用位置的结果。示例:2840
语言全名,可选字段。如果使用此字段,则无需指定 language_code。您可以单独向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 发出请求,以获取可用语言及其 language_name 的列表。忽略此字段可获取所有可用语言的结果。示例:English
语言代码,可选字段。如果使用此字段,则无需指定 language_name。可以通过向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 单独发起请求,获取包含 language_code 的可用语言列表。忽略此字段可获取所有可用语言的结果。示例:en
按项目类型显示结果 可选字段 指示响应中包含的搜索结果类型 注意:如果 item_types 数组包含 organic 以外的项目类型,结果将按数组中的第一个项目类型排序;无法按响应中未包含的搜索结果类型对结果进行排序和筛选;可用值:["organic", "paid", "featured_snippet", "local_pack"] 默认值:["organic", "paid"]
在结果中包含或排除基于点击流的指标数据,可选字段;如果此参数设置为 true,响应中将返回包含点击流数据的 clickstream_etv、clickstream_gender_distribution 和 clickstream_age_distribution 字段。默认值:false。启用此参数后,该请求将按双倍价格收费。有关基于点击流的指标如何计算的更多信息,请参阅此帮助中心文章
返回页面的最大数量,可选字段,默认值:100,最大值:1000
返回的页面在结果数组中的偏移量。可选字段。默认值:0。如果指定值 10,结果数组中的前十个页面将被忽略,并提供后续页面的数据
数据收集模式。可选字段。可使用此字段筛选结果;可用筛选类型:live — 返回指定 target 当前具有排名结果的 SERP 指标;lost — 返回指定 target 以前具有排名结果、但在最近一次检查中不再具有排名结果的 SERP 指标;all — 返回上述两种 SERP 的指标。默认值:live
忽略高度相似的关键词,可选字段。如果设置为 true,则仅返回核心关键词,并排除所有高度相似的关键词;默认值:false
结果过滤参数数组 可选字段 可同时添加多个过滤条件(最多 8 个) 应在条件之间设置逻辑运算符 and、or 支持以下运算符:regex、not_regex、,、,、>、>=、=、,、in、not_in 示例:["metrics.paid.count",">",0] [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","",0]] [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","",0],"or",["metrics.organic.pos_2_3","",0]]] 有关过滤器的更多信息,请参阅 Dataforseo Labs – Filters 或此帮助中心指南
结果排序规则,可选字段。可以使用与 filters 数组中相同的值对结果进行排序。可选排序类型:asc – 结果将按升序排列;desc – 结果将按降序排列。应使用逗号指定排序类型。示例:["metrics.paid.etv,asc"]。注意:单个请求最多可以设置三条排序规则。应使用逗号分隔多条排序规则。示例:["metrics.organic.etv,desc","metrics.paid.count,asc"]。默认规则:["metrics.organic.count,desc"]。注意:如果 item_types 数组包含 organic 以外的项目类型,结果将按数组中的第一个项目类型排序
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
搜索引擎类型
POST 数组中的目标域名
POST 数组中的位置代码;如果没有数据,则值为 null
POST 数组中的语言代码;如果没有数据,则值为 null
数据库中与您的请求相关的结果总量
items 数组中返回的结果数量
相关页面及关联数据
相关页面的绝对 URL
相关页面的排名和流量指标
自然搜索的排名和流量数据
页面排名第 1 的自然搜索结果页(SERP)数量
页面排名第 #2-3 的自然搜索 SERP 数量
页面排名第 4-10 位的自然搜索结果页数量
页面自然搜索结果排名第 11–20 位的数量
页面在自然搜索结果中排名第 21-30 位的 SERP 数量
页面在自然搜索结果中排名第 31-40 位的 SERP 数量
页面排名第 41-50 位的自然搜索结果页数量
页面自然搜索结果排名第 51–60 位的数量
页面排名第 61-70 位的自然搜索结果页数量
页面排名第 71-80 位的自然搜索结果页数量
页面自然搜索结果排名第 81–90 位的数量
页面自然搜索结果排名第 91–100 位的数量
预估流量,页面每月预估自然流量;计算方式为该页面在相应类别中获得排名的所有关键词的 CTR(点击率)与搜索量之乘积的总和;有关该指标计算方式的更多信息,请参阅此帮助中心文章
包含该页面的自然搜索结果页总数
将自然搜索流量转化为付费流量的预估成本,表示为页面所排名类别中的所有关键词投放广告的预估每月成本(USD)。该指标通过 organic etv 与 paid cpc 值的乘积计算得出,表示通过 Google Search 中的 PPC 广告获取预估每月自然流量所需的成本。有关该指标计算方式的更多信息,请参阅此帮助中心文章
新排名元素的数量,表示为该页面发现了多少个新排名元素
排名上升,表示页面中有多少个已排名元素的排名有所提升
排名下降表示页面中有多少个已排名元素的排名下降
丢失的排名元素,表示页面中此前出现在 SERP、但在最近一次检查中未找到的排名元素数量
基于点击流数据估算的流量,即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果,必须将参数 include_clickstream_data 设置为 true 有关此指标计算方式的更多信息,请参阅此帮助中心文章
按性别划分的基于估算点击流的指标分布;要检索此字段的结果,参数 include_clickstream_data 必须设置为 true;有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中的女性用户数量
相关点击流数据集中的男性用户数量
按年龄划分的基于点击流的指标分布。要检索此字段的结果,必须将参数 include_clickstream_data 设置为 true。有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
相关点击流数据集中年龄在 25-34 岁范围内的用户数量
相关点击流数据集中年龄在 35-44 岁范围内的用户数量
相关点击流数据集中年龄在 45-54 岁范围内的用户数量
相关点击流数据集中年龄在 55-64 岁范围内的用户数量
付费搜索的排名和流量数据
页面排名第 1 的付费 SERP 数量
页面排名第 2–3 位的付费 SERP 数量
页面排名第 4-10 位的付费 SERP 数量
该页面排名第 11-20 位的付费 SERP 数量
页面排名第 #21-30 的付费 SERP 数量
页面付费排名为第 31-40 位的 SERP 数量
页面排名第 #41-50 位的付费 SERP 数量
页面排名第 51-60 位的付费 SERP 数量
页面排名第 #61-70 位的付费 SERP 数量
页面排名第 #71-80 的付费 SERP 数量
页面排名第 81-90 位的付费 SERP 数量
页面付费排名为第 91-100 位的 SERP 数量
预估流量,即页面每月预估付费流量,根据该页面在此类别中获得排名的所有关键词的 CTR(点击率)与搜索量之积计算得出。有关此指标计算方法的更多信息,请参阅此帮助中心文章
包含该页面的付费 SERP 总数
预估每月搜索流量成本,表示根据该页面参与排名的类别中所有关键词的 etv 和 cpc 值估算的每月付费流量成本(USD)。如需详细了解该指标的计算方式,请参阅此帮助中心文章。
新排名元素的数量,表示为该页面发现了多少个新排名元素
排名上升,表示页面中有多少个已排名元素的排名有所提升
排名下降表示页面中有多少个已排名元素的排名下降
丢失的排名元素,表示页面中此前出现在 SERP、但在最近一次检查中未找到的排名元素数量
基于点击流数据估算的流量,即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果,必须将参数 include_clickstream_data 设置为 true 有关此指标计算方式的更多信息,请参阅此帮助中心文章
按性别划分的基于估算点击流的指标分布;要检索此字段的结果,参数 include_clickstream_data 必须设置为 true;有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中的女性用户数量
相关点击流数据集中的男性用户数量
按年龄划分的基于点击流的指标分布。要检索此字段的结果,必须将参数 include_clickstream_data 设置为 true。有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
相关点击流数据集中年龄在 25-34 岁范围内的用户数量
相关点击流数据集中年龄在 35-44 岁范围内的用户数量
相关点击流数据集中年龄在 45-54 岁范围内的用户数量
相关点击流数据集中年龄在 55-64 岁范围内的用户数量
Google SERP 精选摘要结果中的排名和流量数据
该页面排名第 1 的精选摘要项目数量
页面排名第 2-3 位的精选摘要项目数量
页面排名第 4-10 位的精选摘要条目数量
页面排名为 #11-20 的精选摘要项数量
页面排名第 21-30 位的精选摘要项数量
页面排名第 #31-40 位的精选摘要条目数量
页面排名第 #41-50 位的精选摘要条目数量
页面排名第 #51-60 位的精选摘要条目数量
页面排名为 #61-70 的精选摘要项数量
页面排名第 71-80 位的精选摘要项数量
页面排名第 #81-90 位的精选摘要条目数量
页面排名第 #91-100 位的精选摘要项数量
预估流量,即页面每月预估付费流量,根据该页面在此类别中获得排名的所有关键词的 CTR(点击率)与搜索量之积计算得出。有关此指标计算方法的更多信息,请参阅此帮助中心文章
包含该页面的精选摘要条目总数
预估每月搜索流量成本,表示根据该页面参与排名的类别中所有关键词的 etv 和 cpc 值估算的每月付费流量成本(USD)。如需详细了解该指标的计算方式,请参阅此帮助中心文章。
新排名元素的数量,表示为该页面发现了多少个新排名元素
排名上升,表示页面中有多少个已排名元素的排名有所提升
排名下降表示页面中有多少个已排名元素的排名下降
丢失的排名元素,表示页面中此前出现在 SERP、但在最近一次检查中未找到的排名元素数量
基于点击流数据估算的流量,即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果,必须将参数 include_clickstream_data 设置为 true 有关此指标计算方式的更多信息,请参阅此帮助中心文章
按性别划分的基于估算点击流的指标分布;要检索此字段的结果,参数 include_clickstream_data 必须设置为 true;有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中的女性用户数量
相关点击流数据集中的男性用户数量
按年龄划分的基于点击流的指标分布。要检索此字段的结果,必须将参数 include_clickstream_data 设置为 true。有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
相关点击流数据集中年龄在 25-34 岁范围内的用户数量
相关点击流数据集中年龄在 35-44 岁范围内的用户数量
相关点击流数据集中年龄在 45-54 岁范围内的用户数量
相关点击流数据集中年龄在 55-64 岁范围内的用户数量
SERP 本地结果包中的排名和流量数据
页面排名第 1 位的本地结果包条目数量
该页面在本地包结果中排名第 2-3 位的项目数量
页面排名第 4-10 位的本地结果包条目数量
页面排名第 11-20 位的本地结果包项目数量
网页排名第 #21-30 位的本地结果包条目数量
页面排名第 31–40 位的本地结果包条目数量
页面排名第 41-50 位的本地结果包条目数量
网页排名第 #51-60 位的本地结果包条目数量
页面排名第 #61-70 位的本地结果包条目数量
网页排名第 #71-80 位的本地结果包条目数量
页面排名第 #81-90 位的本地结果包条目数量
页面排名第 #91-100 位的本地结果包条目数量
预估流量,即页面每月预估付费流量,根据该页面在此类别中获得排名的所有关键词的 CTR(点击率)与搜索量之积计算得出。有关此指标计算方法的更多信息,请参阅此帮助中心文章
包含该页面的本地结果包条目总数
预估每月搜索流量成本,表示根据该页面参与排名的类别中所有关键词的 etv 和 cpc 值估算的每月付费流量成本(USD)。如需详细了解该指标的计算方式,请参阅此帮助中心文章。
新排名元素的数量,表示为该页面发现了多少个新排名元素
排名上升,表示页面中有多少个已排名元素的排名有所提升
排名下降表示页面中有多少个已排名元素的排名下降
丢失的排名元素,表示页面中此前出现在 SERP、但在最近一次检查中未找到的排名元素数量
基于点击流数据估算的流量,即该域名获得排名的所有关键词的点击率与点击流搜索量乘积之和 要获取此字段的结果,必须将参数 include_clickstream_data 设置为 true 有关此指标计算方式的更多信息,请参阅此帮助中心文章
按性别划分的基于估算点击流的指标分布;要检索此字段的结果,参数 include_clickstream_data 必须设置为 true;有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中的女性用户数量
相关点击流数据集中的男性用户数量
按年龄划分的基于点击流的指标分布。要检索此字段的结果,必须将参数 include_clickstream_data 设置为 true。有关该指标计算方式的更多信息,请参阅此帮助中心文章
相关点击流数据集中年龄在 18 至 24 岁范围内的用户数量
相关点击流数据集中年龄在 25-34 岁范围内的用户数量
相关点击流数据集中年龄在 35-44 岁范围内的用户数量
相关点击流数据集中年龄在 45-54 岁范围内的用户数量
相关点击流数据集中年龄在 55-64 岁范围内的用户数量