backlinks/filters

本页说明反向链接接口支持的筛选条件，以及如何获取完整的筛选字段列表。

接口概览

本接口使用以下方法和路径：

GET https://api.seermartech.cn/v3/backlinks/available_filters

调用后将返回反向链接接口支持的筛选字段。筛选和排序规则不额外收费；扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

筛选条件对应 result 数组中的对象，并在对应的 POST 请求体中传。每个请求最多支持 8 个筛选条件，可使用 and 或 or 连接多个条件。

认证

请求时请在 Authorization 请求头中传访问密钥：

Authorization: Bearer smt_live_YOUR_KEY

请求示例

cURL

curl --request GET \
  --url https://api.seermartech.cn/v3/backlinks/available_filters \
  --header 'Authorization: Bearer smt_live_YOUR_KEY'

Python

import requests

url = "https://api.seermartech.cn/v3/backlinks/available_filters"
headers = {
    "Authorization": "Bearer smt_live_YOUR_KEY"
}

response = requests.get(url, headers=headers)
response.raise_for_status()

print(response.json())

TypeScript

const response = await fetch(
  "https://api.seermartech.cn/v3/backlinks/available_filters",
  {
    method: "GET",
    headers: {
      Authorization: "Bearer smt_live_YOUR_KEY",
    },
  },
);

const data = await response.json();
console.log(data);

响应结构

接口返回 JSON 数据 tasks 数组本次请求的任务结果。

字段	类型	说明
version	string	当前 API 版本
status_code	integer	局状态码，完整列表请参错误码文档
status_message	string	局提示信息
time	string	接口执行耗时，单位为秒
cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks_count	integer	tasks 数组中的任务数量
tasks_error	integer	返回错误的任务数量
tasks	array	任务列表
tasks[].id	string	任务唯一标识，UUID 格式
tasks[].status_code	integer	任务状态码，通常为 10000 至 60000
tasks[].status_message	string	任务提示信息
tasks[].time	string	任务执行耗时
tasks[].cost	float	平台原始 USD 成本兼容字段；人民币实扣以 X-SeerMarTech-Charge-CNY 为准。
tasks[].result_count	integer	result 数组中的数量
tasks[].path	array	请求 URL 路径
tasks[].data	object	GET 请求中的参数
tasks[].result	array	可用筛选参数列表，按可使用的接口分组

筛选语法

筛选条件通过请求体中的 filters 字段传递。POST 请求体为 JSON 数组。

[
  {
    "target": "example.com",
    "filters": [
      ["backlink_spam_score", ">", 30],
      "and",
      ["dofollow", "=", true]
    ]
  }
]

多个条件之间插逻辑运算符：

• and：同时满足条件
• or：满足任一条件

最多可传 8 个筛选条件。

筛选条件的基本结构如下：

["字段路径", "运算符", "筛选值"]

字段类型与运算符

字段类型	支持的运算符
bool	=, <>
num	<, <=, >, >=, =, <>, in, not_in
str	match, not_match, like, not_like, ilike, not_ilike, in, not_in, =, <>, regex, not_regex
array.str	has, has_not
array.num	has, has_not
time	<, <=, >, >=, =, <>, in, not_in

注意事项：

• 使用 in 或 not_in 时，筛选值为数组，例如 [200, 301, 302]。
• 时间值应使用 ISO 8601 格式，例如 2021-01-29 15:02:37 +00:00。
• regex 和 not_regex 使用 RE2 正则表达式语法。
• regex 和 not_regex 的表达式长度最多为 1000 个字符。
• like 和 not_like 应使用 % 通符。例如：%seo%。
• 带有 $empty 的字段表示字段名称为空，但仍然可以参与筛选。
• 带有 $key 的字段中，$key 表示 POST 请求 targets 数组中目标页面的序号。

特殊字段说明

Domain Intersection 和 Page Intersection

在以下接口中：

• /v3/backlinks/domain_intersection/live
• /v3/backlinks/page_intersection/live

$key 表示 targets 数组中目标页面的序号。

例如，请求中传：

[
  {
    "targets": [
      "https://example.com/page-a",
      "https://fifa.com/updates",
      "https://example.org/page-c"
    ]
  }
]

则 https://fifa.com/updates 对应的序号为 2，筛选字段应写为：

["2.url_from", "like", "%fifa.com%"]

$empty 字段

在以下接口的 referring_links_semantic_locations 数组中，可能存在标题为空的字段：

• /v3/backlinks/anchors/live
• /v3/backlinks/domain_pages/live
• /v3/backlinks/domain_intersection/live

这些字段使用 $empty 表示，类型为 num。例如：

referring_links_semantic_locations.$empty

TLD 动态字段

以下接口可以响应中 referring_links_tld 对象返回的顶级域名进行筛选：

接口	筛选字段格式
/v3/backlinks/anchors/live	referring_links_tld.$tld
/v3/backlinks/referring_domains/live	referring_links_tld.$tld
/v3/backlinks/referring_networks/live	referring_links_tld.$tld
/v3/backlinks/domain_pages_summary/live	referring_links_tld.$tld
/v3/backlinks/domain_pages/live	page_summary.referring_links_tld.$tld
/v3/backlinks/domain_intersection/live	$key.referring_links_tld.$tld

请将 $tld 替换为响应中返回的顶级域名，例如：

[
  {
    "filters": [
      ["referring_links_tld.com", ">", 10]
    ]
  }
]

referring_links_tld.$tld 支持筛选，不支持作为 order_by 参数进行排序。

Backlinks 接口筛选字段

以下字段适用于反向链接接口中的 backlinks 对象。

字段	类型	说明	支持的运算符或取值
domain_from	str	引用目标域名或页面的域名	=, <>, like, not_like, ilike, not_ilike, match, not_match
url_from	str	反向链接所在页面 URL	同上
url_from_https	bool	引用页面是否使用 HTTPS	=, <>
domain_to	str	反向链接指向的域名	字符串运算符
url_to	str	反向链接指向的页面 URL	字符串运算符
url_to_https	bool	目标 URL 是否使用 HTTPS	=, <>
tld_from	str	引用 URL 的顶级域名	字符串运算符
is_new	bool	是否为新发现的反向链接	=, <>
is_lost	bool	反向链接是否已移除	=, <>
backlink_spam_score	num	反向链接垃圾评分	数值运算符
rank	num	反向链接评级	数值运算符
page_from_rank	num	引用页面评级	数值运算符
domain_from_rank	num	引用域名评级	数值运算符
domain_from_platform_type	array.str	引用域名的平台类型	has, has_not
domain_from_is_ip	bool	引用域名是否为 IP 地址	=, <>

实用场景

• 待补充具体业务场景