DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
OnPage API 瀑布图
某个已爬取 url 的加载时间线——请求了什么、顺序如何、每项耗时多久。读取已完成的爬取,因此需要 post_dataforseo_on_page_submit 返回的 id,并返回 crawl_progress 以及 crawl_status(max_crawl_pages、pages_in_queue 和 pages_crawled)——在采信偏少的结果前先检查这些字段,因为仍在进行的爬取能报告的内容本来就少。用它解释页面为何慢;若要带有评分的性能审计,请改用 post_dataforseo_on_page_lighthouse_live_json。💰 上游免费:查询已完成的爬取不产生费用,只有爬取本身计费。
计费参考
- 计量方式:按上报的响应成本计量。
- 参考请求估算:0.012 美元。
- 参考客户倍率:1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据,不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: object | null · Response36Afe1097B20_OnPageWaterfallResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用,美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_OnPageWaterfallTaskInfo
- 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
结果数组
- crawl类型: string | null
_progress 抓取会话的状态
可能的值:in_progress、finished - crawl类型: object | null · Response36Afe1097B20_CrawlStatusInfo
_status 抓取会话的详细信息
- max类型: integer | null 格式: int64
_crawl _pages 爬取页面数上限 表示设置任务时指定的 max_crawl_pages 限制
- pages类型: integer | null 格式: int64
_crawled 已爬取的页面数量
- pages类型: integer | null 格式: int64
_in _queue 当前在爬取队列中的页面数量
- items类型: array (object | null)[] | null
条目数组
- connection类型: integer | null
_time 连接服务器的时间
与服务器建立连接所需的时间(毫秒) - dom类型: integer | null
_complete 加载资源的时间
下载页面及其所有子资源所需的时间(毫秒) - download类型: integer | null
_time 浏览器接收响应所需的时间(毫秒)
- duration类型: integer | null
_time 浏览器从服务器接收完整响应所需的总时间(毫秒)
- fetch类型: integer | null
_end 完成下载 HTML 资源的时间
浏览器完成页面下载所需的时间 - fetch类型: integer | null
_start 开始下载 HTML 资源的时间
浏览器开始下载页面所需的时间 - page类型: string | null
_url 页面的 URL
- request类型: integer | null
_sent _time 向服务器发送请求的时间
向服务器发送请求所需的时间(毫秒) - resources类型: array (object | null)[] | null
资源特定计时
包含页面上每个资源的独立计时数组- duration类型: integer | null
_time 浏览器从服务器接收完整响应所需的总时间(毫秒)
- fetch类型: integer | null
_end 完成下载 HTML 资源的时间
浏览器完成页面下载所需的时间 - fetch类型: integer | null
_start 开始下载 HTML 资源的时间
浏览器开始下载页面所需的时间 - initiator类型: string | null
资源发起者
- is类型: boolean | null
_render _blocking 指示资源是否阻止渲染
- location类型: object | null · Response36Afe1097B20_OnPageResourceLocationInfo
资源在文档中的位置
定义特定资源在文档 HTML 中位置的参数- line类型: integer | null
行号
资源所在的行号 - offset类型: integer | null
_left 行内位置
资源之前的行字符数;
有时称为列
注意:从 1 开始计数,即如果资源左侧没有任何字符,该值为 1 - offset类型: integer | null
_top 文档中的位置
资源与 HTML 顶部之间的字符总数
- resource类型: string | null
_type - url类型: string | null
资源 URL
- time类型: integer | null
_to _interactive Time To Interactive (TTI) 指标
用户可与页面交互所需的时间(毫秒) - time类型: integer | null
_to _secure _connection 建立安全连接的时间
与服务器建立安全连接所需的时间(毫秒) - waiting类型: integer | null
_time
- items类型: integer | null 格式: int64
_count 结果数组中的条目数
- 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/on_page/waterfall \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "08101204-0696-0216-0000-644a7b21a48a",
"url": "https://dataforseo.com/tag/broken-links"
}
]'
{
"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": [
{
"crawl_progress": null,
"crawl_status": {
"max_crawl_pages": null,
"pages_in_queue": null,
"pages_crawled": null
},
"items_count": null,
"items": [
{
"page_url": null,
"time_to_interactive": null,
"dom_complete": null,
"connection_time": null,
"time_to_secure_connection": null,
"request_sent_time": null,
"waiting_time": null,
"download_time": null,
"duration_time": null,
"fetch_start": null,
"fetch_end": null,
"resources": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}