历史批量流量估算
此端点将为您提供最多 1,000 个域名在指定时间范围内收集的历史月度流量数据,最早可追溯至 2020 年 10 月。
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
请求体
目标域名和子域名,必填字段。可在此字段中指定域名和子域名;指定时不应包含 https:// 和 www.;最多可设置 1000 个域名或子域名
位置的完整名称。如果使用此字段,则无需指定 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
时间范围的起始日期,可选字段;如果未指定此字段,将提供过去 12 个月的数据;最小可用值:2020-10-01;日期格式:"yyyy-mm-dd"
时间范围的结束日期,可选字段。如果未指定此字段,默认使用当天日期;日期格式:"yyyy-mm-dd";示例:"2021-04-01"
忽略高度相似的关键词,可选字段。如果设置为 true,则仅返回核心关键词,并排除所有高度相似的关键词;默认值:false
按项目类型显示结果,可选字段。指示响应中包含的搜索结果类型;注意:如果 item_types 数组包含 organic 以外的项目类型,结果将按数组中的第一个项目类型排序;可选值:["organic", "paid", "featured_snippet", "local_pack"]。默认值:["organic", "paid"]
用户定义的任务标识符。可选字段。字符数限制为 255。您可以使用此参数标识任务并将其与结果匹配;您将在响应的 data 对象中找到指定的 tag 值
响应
成功响应
API 的当前版本
通用状态码;您可以在此处查看完整的响应码列表。注意:我们强烈建议设计必要的系统来处理相关异常或错误情况
常规信息消息;可在此处查看常规信息消息的完整列表
执行时间(秒)
任务总成本(美元)
tasks 数组中的任务数量
返回错误的 tasks 数组中的任务数量
任务数组
任务标识符,系统中采用 UUID 格式的唯一任务标识符
DataForSEO 生成的任务状态码;范围为:10000-60000;完整响应代码列表可在此处查看
任务的信息性消息,你可以在此处查看通用信息性消息的完整列表
执行时间(秒)
任务成本(美元)
结果数组中的元素数量
URL 路径
包含您在 POST 请求中指定的相同参数
结果数组
搜索引擎类型
POST 数组中的位置代码;如果没有数据,则值为 null
POST 数组中的语言代码;如果没有数据,则值为 null
数据库中与您的请求相关的结果总量
items 数组中返回的结果数量
包含相关流量估算数据的项目数组
搜索引擎类型
POST 数组中的目标域名
与指定域名相关的流量数据
自然搜索流量数据
所提供数据对应的年份
数据对应的月份
预估流量 域名的预估自然搜索月流量,计算方式为该域名参与排名的所有关键词的 CTR(点击率)与搜索量之乘积的总和;有关此指标计算方式的更多信息,请参阅此帮助中心文章
包含该域名的自然搜索 SERP 总数
付费搜索的流量数据
所提供数据对应的年份
数据对应的月份
预估流量:域名的预估每月付费流量,计算方式为该域名排名涉及的所有关键词的 CTR(点击率)与搜索量之积;有关此指标计算方式的更多信息,请参阅此帮助中心文章
包含该域名的付费 SERP 总数
来自 Google SERP 精选摘要结果的流量数据
所提供数据对应的年份
数据对应的月份
预估流量;域名的预估每月付费流量,计算方式为该域名在相应类别中有排名的所有关键词的 CTR(点击率)与搜索量之乘积。有关该指标计算方式的更多信息,请参阅此帮助中心文章
包含该域名的精选摘要项总数
SERP 本地结果包中的流量数据
所提供数据对应的年份
数据对应的月份
预估流量;域名的预估每月付费流量,计算方式为该域名在相应类别中有排名的所有关键词的 CTR(点击率)与搜索量之乘积。有关该指标计算方式的更多信息,请参阅此帮助中心文章
包含该域名的本地结果包条目总数