v0.2.0-beta

OpenAPI 3.1.0

域名页面

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

post/v1/beta/dataforseo/backlinks/domain_pages/live

域名页面

单个 target 中有入站链接的页面，以及爬虫对每个页面的视图：main_domain、domain、tld、page、ip、first_visited、prev_visited 和 fetch_time。用它找出哪些页面真正获得了链接。若要查看逐页反向链接计数而非抓取元数据，请使用 post_dataforseo_backlinks_domain_pages_summary_live。

计费参考

计量方式：按上报的响应成本计量。
参考请求估算：0.0276 美元。
参考客户倍率：1.0。不得对已结算的客户金额再次应用。

仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。

请求体

application/json

类型: array (object | null)[]
- backlinks_filters
  类型: array (object | null)[] | null
  
  筛选 target 的反向链接
  可选字段
  可使用此字段筛选将纳入 target 汇总指标数据集的初始反向链接
  可按此端点响应中所有可用字段筛选反向链接
  使用此参数，可以在响应中只纳入 dofollow 反向链接，并创建灵活的数据集用于计算指标
  示例：
  "backlinks_filters": ["dofollow", "=", true]
  
  空对象
- backlinks_status_type
  类型: string | null
  
  设置要返回和统计的反向链接
  可选字段
  可使用此字段选择将返回并用于汇总指标的反向链接；
  可选值：
  all - 返回并统计所有反向链接；
  live - 返回并统计上次检查中发现的反向链接；
  lost - 返回并统计已丢失的反向链接；
  
  默认值：live
- exclude_internal_backlinks
  类型: boolean | null
  
  表示是否从结果中排除从子域名指向 target 的内部反向链接
  可选字段
  如果设为 true，结果将不包含来自与 target 同域名的子域名的内部反向链接数据
  如果设为 false，结果将包含内部链接
  默认值：true
- filters
  类型: array (object | null)[] | null
  
  结果筛选参数数组
  可选字段
  可同时添加多个筛选条件（最多 8 个）
  应在条件之间设置逻辑运算符 and、or
  支持以下运算符：
  regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
  可将 % 运算符与 like、not_like 配合使用，匹配任意长度（含零个字符）的字符串
  示例：
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  完整的可用筛选条件列表见此处。
  
  空对象
- include_subdomains
  类型: boolean | null
  
  表示 target 的子域名是否包含在搜索中
  可选字段
  如果设为 false，将忽略子域名
  默认值：true
- internal_list_limit
  类型: integer | null
  
  内部数组中的最大元素数
  可选字段
  可使用此字段限制以下数组中的元素数量：
  referring_links_tld
  referring_links_types
  referring_links_attributes
  referring_links_platform_types
  referring_links_semantic_locations
  
  默认值：10
  最大值：1000
- limit
  类型: integer | null
  
  返回页面的最大数量
  可选字段
  默认值：100
  最大值：1000
- offset
  类型: integer | null
  
  返回的页面在结果数组中的偏移量
  可选字段
  默认值：0
  如果指定 10，结果数组中的前十个页面将被跳过，并返回后续页面的数据
- order_by
  类型: array string[] | null
  
  结果排序规则
  可选字段
  可使用与 filters 数组相同的值对结果排序
  可用的排序类型：
  asc - 结果按升序排列
  desc - 结果按降序排列
  应使用逗号设置排序类型
  示例：
  ["page_summary.backlinks,desc"]
  注意，单个请求中最多可设置三条排序规则
  应使用逗号分隔多条排序规则
  示例：
  ["page_summary.backlinks,desc","page_summary.rank,asc"]
- rank_scale
  类型: string | null
  
  定义用于计算和显示 rank、domain_from_rank 和 page_from_rank 值的刻度
  可选字段
  
  可使用此参数选择 rank 值以 0–100 还是 0–1000 的刻度显示
  
  可选值：
  one_hundred — rank 值以 0–100 的刻度显示
  one_thousand — rank 值以 0–1000 的刻度显示
  
  默认值：one_thousand
  
  有关此参数的工作方式以及排名指标的计算方式，请参阅这篇帮助中心文章
- tag
  类型: string | null
  
  用户自定义任务标识符
  可选字段
  字符数上限为 255
  可使用此参数标识任务，并将其与结果对应
  可在响应的 data 对象中找到指定的 tag 值
- target
  类型: string
  
  域名或子域名
  必填字段
  域名或子域名不应包含 https:// 和 www.
  示例：
  forbes.com

响应

200
类型: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveResponseInfo
cost
类型: number | null 格式: double

任务总费用，美元

status_code
类型: integer | null

通用状态码完整响应码列表见此处

status_message
类型: string | null

通用信息性消息完整的一般信息性消息列表见此处

tasks
类型: array (object | null)[] | null

任务数组

类型: object | null · Response36Afe1097B20_BacklinksDomainPagesLiveTaskInfo
cost
类型: number | null 格式: double

任务总费用，美元

data
类型: object | null

包含你在 POST 请求中指定的相同参数

propertyName
类型: object | null
id
类型: string | null

任务标识符我们系统中 UUID 格式的唯一任务标识符

path
类型: array (string | null)[] | null

URL 路径

result
类型: array (object | null)[] | null

结果数组

items
类型: array (object | null)[] | null

条目数组

content_encoding
类型: string | null

编码类型

domain
类型: string | null

域名
找到该页面的域名

encoded_size
类型: integer | null

编码后的页面大小
表示编码后页面的大小，单位为字节

fetch_time
类型: string | null

我们的爬虫最近一次访问该页面的日期和时间
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2017-01-24 13:20:59 +00:00

first_visited
类型: string | null

首次访问页面的日期和时间
我们的爬虫首次访问该页面的日期和时间
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2017-01-24 13:20:59 +00:00

ip
类型: string | null

IP 地址

location
类型: string | null

Location 响应头
表示页面存在重定向时指向的目标 URL

main_domain
类型: string | null

主网站域名
主网站域名不包含子域名

media_type
类型: string | null

用于展示页面的媒体类型

meta
类型: object | null · Response36Afe1097B20_BacklinksPageMeta

页面元数据

canonical
类型: string | null

规范页面

charset
类型: string | null

字符编码
示例：
utf-8

external_links_count
类型: integer | null 格式: int64

页面上的外部链接数量

h1
类型: array (string | null)[] | null

h1 标签
h1 标签的内容

h2
类型: array (string | null)[] | null

h2 标签
h2 标签的内容

h3
类型: array (string | null)[] | null

h3 标签
h3 标签的内容

images_alt
类型: array (string | null)[] | null

alt 标签的内容

images_count
类型: integer | null 格式: int64

页面上的图片数量

internal_links_count
类型: integer | null 格式: int64

页面上的内部链接数量

language
类型: string | null

页面内容语言
示例：
en

page_spam_score
类型: integer | null

页面的垃圾评分
有关该指标计算方式的更多信息，请参阅这篇帮助中心页面

platform_type
类型: array (string | null)[] | null

平台类型

powered_by
类型: array (string | null)[] | null

CMS 详细信息

social_media_tags
类型: object | null
propertyName
类型: string | null
technologies
类型: object | null

网站技术

propertyName
类型: string | null
title
类型: string | null

页面标题

words_count
类型: integer | null 格式: int64

页面上的单词数量

page
类型: string | null

页面 URL
相关页面的 URL

page_summary
类型: object | null · Response36Afe1097B20_PageSummary

包含该页面的反向链接数据

backlinks
类型: integer | null 格式: int64

表示反向链接数量

backlinks_spam_score
类型: integer | null 格式: int64

指向该页面的反向链接的平均垃圾评分
有关该指标计算方式的更多信息，请参阅这篇帮助中心页面

broken_backlinks
类型: integer | null 格式: int64

损坏的反向链接数
指向 page 的损坏反向链接数

broken_pages
类型: integer | null

失效页面数量
反向链接所指向的、响应 4xx 或 5xx 状态码的页面数量

first_seen
类型: string | null

我们的爬虫首次发现该反向链接的日期和时间
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2019-11-15 12:57:46 +00:00

lost_date
类型: string | null

此页面最后一个反向链接丢失的日期和时间
表示我们的爬虫访问该页面并收到 4xx 或 5xx 状态码，或最后一个反向链接被移除的日期和时间
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2017-01-24 13:20:59 +00:00

rank
类型: integer | null

页面排名
page 的排名
rank 基于链接数据库中节点排名的方法计算——这一原理源自最初的 Google PageRank 算法
有关该指标及其计算方式的更多信息，请参阅这篇帮助中心文章

referring_domains
类型: integer | null 格式: int64

表示引用域名数量

referring_domains_nofollow
类型: integer | null 格式: int64

向 page 指向至少一个 nofollow 链接的域名数量

referring_ips
类型: integer | null 格式: int64

引用 IP 地址数量
指向该页面的 IP 地址数量

referring_links_attributes
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_countries
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_platform_types
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_semantic_locations
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_tld
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_links_types
类型: object | null
propertyName
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_main_domains
类型: integer | null 格式: int64

表示引用主域名数量

referring_main_domains_nofollow
类型: integer | null 格式: int64

Signed 64-bit integers (long type).

referring_pages
类型: integer | null 格式: int64

表示指向 page 的页面数

referring_pages_nofollow
类型: integer | null 格式: int64

向 page 指向至少一个 nofollow 链接的引用页面数量

referring_subnets
类型: integer | null 格式: int64

引用子网数量

prev_visited
类型: string | null

我们的爬虫最近一次访问该页面之前的日期
采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
示例：
2017-01-24 13:20:59 +00:00

server
类型: string | null

服务器版本

size
类型: integer | null

表示页面大小，单位为字节

status_code
类型: integer | null

通用状态码
可在此处找到响应码的完整列表
注意：我们强烈建议设计必要的系统来处理相关的异常或错误情况

tld
类型: string | null

顶级域名
DNS 根区中的顶级域名

type
类型: string | null

元素类型

items_count
类型: integer | null 格式: int64

items 数组中的项目数量

target
类型: string | null

POST 数组中的 target

total_count
类型: integer | null 格式: int64

数据库中相关条目的总数

result_count
类型: integer | null 格式: int64

result 数组中的元素数

status_code
类型: integer | null

任务的状态码由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处

status_message
类型: string | null

任务的信息性消息完整的一般信息性消息列表见此处

time
类型: string | null

执行时间，秒

tasks_count
类型: integer | null 格式: int64

tasks 数组中的任务数

tasks_error
类型: integer | null 格式: int64

tasks 数组中返回错误的任务数

time
类型: string | null

总执行时间，秒

version
类型: string | null

API 的当前版本
application/json
400

无法处理该请求。请检查请求参数。
401

需要有效的 Felo API 密钥。
402

由于未满足计费要求，请求无法继续。
403

该账户无权执行此操作。
429

已达到请求或支出限额。
502

服务无法完成该请求。
503

API 或计费服务暂时不可用。
504

服务在处理请求时超时。
default

错误响应；上游透传响应可能采用提供方格式

application/json

post/v1/beta/dataforseo/backlinks/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

显示 Schema

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

操作成功

需要帮助？

API、计费或账号问题，请联系支持。
在 Discord 上与 Felo 开发者交流。
查看我们的更新日志。
需要批量定价或采购支持？联系销售。
正在使用 LLM 构建？阅读 llms.txt。

域名页面

身份验证Required

DataForSEO

域名页面

计费参考

需要帮助？