API 文档 / 域名历史检测 / 建站历史批量查询

建站历史批量查询

接口地址:
localhost:88/api/v1/{apikey}/wayback/query 获取私钥
请求方式:
GET
返回格式:
JSON
请求示例:
localhost:88/api/v1/{apikey}/wayback/query?domains=test123.com
接口备注:
批量查询域名建站历史

请求参数说明

名称 类型 必填 说明
domains String 域名,多个用逗号分隔

返回参数说明

名称 类型 说明
count Int 查询域名总数
results Array 查询结果列表
results[].domain String 域名
results[].first_ts String 首次收录时间戳(格式:yyyyMMddHHmmss)
results[].last_ts String 最后收录时间戳
results[].first_snapshot String 首次快照路径
results[].last_snapshot String 最后快照路径
results[].total_count Int 历史快照总数
results[].year_count Int 有快照的年份数
results[].month_count Int 有快照的月份数
results[].years Array 按年统计列表
results[].years[].year String 年份
results[].years[].count Int 该年快照数
results[].years[].months Array 该年按月统计
results[].years[].months[].month Int 月份(1-12)
results[].years[].months[].count Int 该月快照数
results[].detail_status String 详情状态:partial/full/none
results[].status String 查询状态:ok/not_found/error
results[].cached Boolean 是否来自缓存
results[].title_count Int 已提取标题的快照数
results[].html_count Int 已下载HTML的快照数
results[].latest_title String 最新首页标题
results[].content_uniformity Int 历史内容一致性(0-100,越高越一致)
results[].recent_5y_content_uniformity Int 近5年内容一致性
results[].longest_consecutive_years Int 最长连续建站年数
results[].longest_consecutive_range String 最长连续建站年份范围
results[].recent_5y_count Int 近5年快照数
results[].recent_5y_consecutive Int 近5年连续建站月数
results[].latest_lang String 最新首页语言编码
data.domain String 域名
data.detail_status String 详情状态:none(初始)/partial(标题拉取中)/complete(已完成)
data.preload_done Boolean 是否已完成补拉
data.cached Boolean 是否来自缓存
data.snapshots Array 年月快照列表(含标题和跳转链接)
data.snapshots[].year_month String 年月(如 202103)
data.snapshots[].snapshot_ts String 快照时间戳
data.snapshots[].title String 首页标题(空表示尚未拉取)
data.snapshots[].snapshot_url String 快照跳转链接
data.snapshots[].has_html Boolean 是否有缓存的HTML
data.latest_title String 最新首页标题
data.latest_lang String 最新首页语言编码
data.title_count Int 已拉取标题的快照数
data.html_count Int 已缓存的HTML快照数
data.has_missing Boolean 是否还有缺标题/HTML的快照
code Int 状态码(200成功,非200失败)
message String 返回消息
data Object 返回数据

JSON 返回示例

JSON
{
	"code": 200,
	"message": "操作成功",
	"data": {
		"count": 1,
		"results": [
			{
				"domain": "test123.com",
				"first_ts": "20130821030323",
				"last_ts": "20130821030323",
				"first_snapshot": "/web/20130821030323/test123.com",
				"last_snapshot": "/web/20130821030323/test123.com",
				"total_count": 1,
				"year_count": 1,
				"month_count": 1,
				"years": [
					{
						"year": "2013",
						"count": 1,
						"months": [
							{
								"count": 1,
								"month": 8
							}
						]
					}
				],
				"detail_status": "partial",
				"status": "ok",
				"cached": true,
				"title_count": 0,
				"html_count": 0,
				"latest_title": "",
				"content_uniformity": 0,
				"recent_5y_content_uniformity": 0,
				"longest_consecutive_years": 1,
				"longest_consecutive_range": "2013-2013",
				"recent_5y_count": 0,
				"recent_5y_consecutive": 0,
				"latest_lang": ""
			}
		]
	}
}

接口状态码说明

所有 API 接口统一使用以下错误码格式返回,请根据 code 值判断请求结果。

状态码 类型 说明
200 成功 请求成功,data 字段包含返回数据
401 认证错误 缺少 API Key 或 API Key 无效。请检查 URL 路径中的 {apikey} 是否正确,或联系客服获取有效密钥
403 权限错误 账号已被禁用,无法调用接口。请联系客服解封
422 参数错误 请求参数验证失败。请检查参数名称、格式和必填项是否符合接口文档要求
500 服务端错误 服务器内部异常。若频繁出现请联系客服处理