DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
链接
按 id 获取爬取过程中发现的每个链接。用 page_from 和 page_to 过滤，取出从某个页面出去或指向某个页面的链接。返回 total_items_count、items_count、items，以及用于分页的 search_after_token——前几页之后请用它，而不是 offset。读取已完成的爬取，因此需要 post_dataforseo_on_page_submit 返回的 id，并返回 crawl_progress 以及 crawl_status（max_crawl_pages、pages_in_queue 和 pages_crawled）——在采信偏少的结果前先检查这些字段，因为仍在进行的爬取能报告的内容本来就少。💰 上游免费：查询已完成的爬取不产生费用，只有爬取本身计费。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.012 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array (object | null)[]
- filters类型: array (object | null)[] | null
结果筛选参数数组
可选字段
可同时添加多个筛选条件（最多 8 个）
应在条件之间设置逻辑运算符and、or
支持以下运算符：regex、not_regex、=、<>、in、not_in、like、not_like
可以将%运算符与like和not_like一起使用，匹配任意长度（零个或多个字符）的字符串
示例：["direction","=","external"][["domain_to","<>","example.com"],
"and",
["link_from","not_like","%example.com/blog%"]][["direction","=","external"],
"and",
[["link_from","like","%example.com/blog%"],"or",["link_from","like","%example.com/help%"]]]空对象 - id类型: string
- limit类型: integer | null
返回链接的最大数量
可选字段
默认值：100
最大值：1000 - offset类型: integer | null
返回链接结果数组中的偏移量
可选字段
默认值：0
最大值：2000000
如果指定10，结果数组中的前十个链接将被省略，数据将针对后续链接提供 - page类型: string | null
_from 页面相对 URL
可选字段
如果使用此字段，API 响应将仅包含来自指定页面的链接
请注意，此字段只能指定相对 URL - page类型: string | null
_to 页面相对 URL
可选字段
如果使用此字段，API 响应将仅包含指向指定页面的内部链接
请注意，此字段只能指定相对 URL - search类型: string | null
_after _token 后续请求的令牌
可选字段
在每个请求响应的对应字段中提供；
使用此参数可避免在单个请求中尝试获取超过20,000条结果时超时；
通过指定响应数组中的唯一search_after_token值，可获取初始任务的后续结果；search_after_token值对每个后续任务都是唯一的；
注意：如果请求中指定了search_after_token，其他所有参数都应与此前的请求完全相同 - tag类型: string | null
用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
可在响应的data对象中找到指定的tag值
- 类型: object | null · Response36Afe1097B20_OnPageLinksResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用，美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_OnPageLinksTaskInfo
- 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 当前在爬取队列中的页面数量
- current类型: integer | null
_offset Integer numbers.
- items类型: array (object | null)[] | null
条目数组
- direction类型: string | null
链接方向
可能的值：internal、external - dofollow类型: boolean | null
表示链接是否为 dofollow
如果值为true，则该链接没有rel="nofollow"属性 - domain类型: string | null
_from 引用域名
该链接是在此域名上发现的 - domain类型: string | null
_to 被引用域名
该链接指向此域名 - is类型: boolean | null
_broken 链接已失效
表示链接是否指向失效的页面或资源 - is类型: boolean | null
_link _relation _conflict 表示该链接可能与其他链接存在冲突
如果为true，则至少有一个指向link_to的链接具有rel="nofollow"属性，并且至少有一个是 dofollow - link类型: string | null
_from 引用页面
发现该链接的页面的绝对 URL - link类型: string | null
_to 被引用页面
该链接所指向页面的绝对 URL - page类型: string | null
_from 引用页面
发现该链接的页面的相对 URL - page类型: string | null
_from _scheme - page类型: string | null
_to 被引用页面
该链接所指向页面的相对 URL - page类型: string | null
_to _scheme - page类型: integer | null
_to _status _code 被引用页面的状态码
该链接所指向页面的状态码 - type类型: string | null
元素类型
- items类型: integer | null 格式: int64
_count 结果数组中的条目数
- search类型: string | null
_after _token - total类型: integer | null 格式: int64
_items _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/links \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"id": "07281559-0695-0216-0000-c269be8b7592",
"page_from": "/apis/google-trends-api",
"filters": [
[
"dofollow",
"=",
true
],
"and",
[
"direction",
"=",
"external"
]
],
"limit": 10
}
]'
{
"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
},
"search_after_token": null,
"current_offset": null,
"total_items_count": null,
"items_count": null,
"items": [
{
"type": null,
"domain_from": null,
"domain_to": null,
"page_from": null,
"page_to": null,
"link_from": null,
"link_to": null,
"dofollow": null,
"page_from_scheme": null,
"page_to_scheme": null,
"direction": null,
"is_broken": null,
"is_link_relation_conflict": null,
"page_to_status_code": null
}
]
}
]
}
]
}