DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
新增与丢失反向链接时间序列汇总
单个 target 每个周期的新增与丢失反向链接及引用域名，按 group_range 分组。这是 post_dataforseo_backlinks_timeseries_summary_live 的导数：后者给出水平，本端点给出变化。总量持平但实际剧烈更替的情况只会在这里显现。若要在多个目标上一次性获取相同数据，请使用 post_dataforseo_backlinks_bulk_new_lost_backlinks_live。该端点不接受 limit 参数，唯一的调节手段就是减少调用次数。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.0372 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array (object | null)[]
- date类型: string | null
_from 时间范围的开始日期
可选字段
此字段表示用作新增和丢失反向链接及引荐域名判定阈值的日期；
在指定日期之后出现在我们索引中的反向链接和引荐域名将被视为新增；
在指定日期之后未找到、但此前存在的反向链接和引荐域名将被视为丢失；最小值：
2019-01-30
最大值不应超过date_to中指定的日期
日期格式："yyyy-mm-dd"
示例："2021-01-01" - date类型: string | null
_to 时间范围的结束日期
可选字段
如果未指定此字段，将默认使用今天的日期
最小值不应早于date_from中指定的日期
最大值：今天的日期
日期格式："yyyy-mm-dd"
示例："2021-01-15" - group类型: string | null
_range 用于对结果分组的时间范围
可选字段
默认值：month
可选值：day、week、month、year注意：对于
day，我们将返回date_from与date_to之间（含两端）所有日期对应的项；
对于week/month/year，我们将返回完整周/月/年对应的项，每项指示该周/月/年的最后一天例如，如果指定：
"group_range": "month",
"date_from": "2022-03-23",
"date_to": "2022-05-13"
我们将返回 2022-03-01 至 2022-05-31 之间的项，即对应以下日期的三项：2022-03-31、2022-04-30、2022-05-31如果某个
day/week/month/year没有数据，我们将返回0 - include类型: boolean | null
_subdomains 表示
target的子域名是否包含在搜索中
可选字段
如果设为false，将忽略子域名
默认值：true - tag类型: string | null
用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
可在响应的data对象中找到指定的tag值 - target类型: string
要获取数据的域名
必填字段
域名不应包含https://和www.
示例："forbes.com"
- 类型: object | null · Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用，美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveTaskInfo
- cost类型: number | null 格式: double
任务总费用，美元
- data类型: object | null
包含你在 POST 请求中指定的相同参数
- property类型: object | null
Name
- id类型: string | null
任务标识符 我们系统中 UUID 格式的唯一任务标识符
- path类型: array (string | null)[] | null
URL 路径
- result类型: array (object | null)[] | null
结果数组
- date类型: string | null
_from 时间范围的开始日期
采用 UTC 格式：“yyyy-mm-dd”
示例：2019-01-01 - date类型: string | null
_to 时间范围的结束日期
采用 UTC 格式："yyyy-mm-dd"
示例："2019-01-15" - group类型: string | null
_range POST 数组中的
group_range - items类型: array (object | null)[] | null
包含相关的反向链接和引用域名数据
- date类型: string | null
目标数据的存储日期和时间
采用 UTC 格式："yyyy-mm-dd hh-mm-ss +00:00"
示例：2019-11-15 12:57:46 +00:00 - lost类型: integer | null 格式: int64
_backlinks 丢失的反向链接数量
target的丢失反向链接数量 - lost类型: integer | null 格式: int64
_referring _domains 丢失的引用域名数量
target的丢失引用域名数量 - lost类型: integer | null 格式: int64
_referring _main _domains 丢失的引用主域名数量
target的丢失引用主域名数量 - new类型: integer | null 格式: int64
_backlinks 新增反向链接数量
指向target的新增反向链接数量 - new类型: integer | null 格式: int64
_referring _domains 新增引用域名数量
指向target的新增引用域名数量 - new类型: integer | null 格式: int64
_referring _main _domains 新增引用主域名数量
指向target的新增引用主域名数量 - type类型: string | null
元素类型
- items类型: integer | null 格式: int64
_count items数组中返回的结果数 - target类型: string | null
POST 数组中的
target
- result类型: integer | null 格式: int64
_count result 数组中的元素数
- status类型: integer | null
_code 任务的状态码 由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处
- status类型: string | null
_message 任务的信息性消息 完整的一般信息性消息列表见此处
- time类型: string | null
执行时间，秒
- 类型: integer | null 格式: int64tasks
_count tasks 数组中的任务数
- 类型: integer | null 格式: int64tasks
_error tasks 数组中返回错误的任务数
- 类型: string | nulltime
总执行时间，秒
- 类型: string | nullversion
API 的当前版本
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"target": "dataforseo.com",
"date_from": "2021-12-01",
"date_to": "2022-02-01",
"group_range": "month"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"target": null,
"date_from": null,
"date_to": null,
"group_range": null,
"items_count": null,
"items": [
{
"type": null,
"date": null,
"new_backlinks": null,
"lost_backlinks": null,
"new_referring_domains": null,
"lost_referring_domains": null,
"new_referring_main_domains": null,
"lost_referring_main_domains": null
}
]
}
]
}
]
}