查询 site: 收录巡检结果

获取您名下域名在各大搜索引擎（必应 Bing / 百度 Baidu）自动执行的 site:domain 收录巡检结果，包括估算收录量、收录页面快照列表（标题、URL、摘要）、连续未收录次数及下次计划巡检时间。

接口一：分页查询收录巡检日志 (/api/site-monitor/logs)

参数名	类型	必填	说明
`page`	integer	否	当前页码，从 `1` 开始。
`size`	integer	否	每页返回条数，最大值为 `100`。
`domain`	string	否	按域名模糊筛选（如 `example.com`）。
`engine`	string	否	按搜索引擎筛选：`bing`（必应）或 `baidu`（百度）。不传则返回全部引擎。
`has_indexed`	boolean	否	按收录状态筛选：`true` 仅看有收录（`indexed_count > 0`），`false` 仅看未收录（`indexed_count = 0`）。
`has_results`	boolean	否	是否包含具体收录网页快照条目：`true` 仅看有快照列表的记录，`false` 仅看无快照列表的记录。
`has_active_keywords`	boolean	否	按域名下是否存在运行中关键词筛选（`true` / `false`）。
`sort_by`	string	否	排序字段，支持：`created_at`（巡检时间）、`indexed_count`（估算收录量）、`active_keywords_count`（运行中词数）、`site_failures`（连续未收录次数）、`next_site_check_at`（下次检测时间）。
`sort_desc`	boolean	否	是否降序排列：`true` 降序，`false` 升序。

接口二：获取单域名最新收录快照 (/api/site-monitor/latest-results)

参数名	类型	必填	说明
`domain`	string	是	目标域名（如 `example.com`，系统会自动去除首尾空格及尾斜杠）。
`search_engine`	string	是	目标搜索引擎：`bing` 或 `baidu`。

返回值字段说明

响应数据结构

total

（/api/site-monitor/logs 返回）符合筛选条件的巡检记录总数。

logs[].domain / search_engine / keyword

巡检的目标域名、搜索引擎标识（bing / baidu）及实际执行的检索指令（如 site:example.com）。

logs[].indexed_count

搜索引擎返回的估算收录结果数（整数，0 表示未收录）。

logs[].results_json / data

收录页面快照数组。每个元素包含 title（网页标题）、url（收录链接）与 snippet（网页摘要描述）。

logs[].screenshot_key

本次巡检的 SERP 截图标识（若有截图，可通过获取干预执行截图接口预览）。

logs[].site_failures / next_site_check_at

当前连续未检出收录的累计次数，以及系统计划下一次执行 site: 巡检的时间（UTC+8）。

分页查询收录巡检日志

GET

curl -X GET "https://www.fashionbashusa.com/api/site-monitor/logs?page=1&size=10&domain=example.com&engine=bing" \
     -H "Authorization: Bearer YOUR_API_KEY"

巡检日志响应示例 (200 OK)

{
  "success": true,
  "total": 1,
  "logs": [
    {
      "id": 10824,
      "domain": "example.com",
      "search_engine": "bing",
      "keyword": "site:example.com",
      "indexed_count": 42,
      "screenshot_key": "site_checks/20261031/example_com_bing.webp",
      "results_json": [
        {
          "title": "Example Official Website - Home",
          "url": "https://example.com/",
          "snippet": "Welcome to Example.com, providing high quality services..."
        }
      ],
      "created_at": "2026-10-31 12:00:00",
      "active_keywords_count": 15,
      "user_id": 10086,
      "site_failures": 0,
      "next_site_check_at": "2026-11-01 12:00:00"
    }
  ]
}

获取单域名最新收录快照

GET

curl -X GET "https://www.fashionbashusa.com/api/site-monitor/latest-results?domain=example.com&search_engine=bing" \
     -H "Authorization: Bearer YOUR_API_KEY"

最新收录快照响应示例 (200 OK)

{
  "success": true,
  "data": [
    {
      "title": "Example Official Website - Home",
      "url": "https://example.com/",
      "snippet": "Welcome to Example.com, providing high quality services..."
    },
    {
      "title": "Products & Pricing - Example",
      "url": "https://example.com/pricing",
      "snippet": "Explore flexible plans and enterprise solutions on Example.com."
    }
  ]
}