> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎么只搜某个官网，不要其他网站转载？

> 在 POST /v1/web/search 的 include_domains 中传入最多 10 个官方域名（适用于 web、news、images、videos），即可过滤第三方转载，再用 POST /v1/web/read 核对公告原文。

在 `POST /v1/web/search` 中通过 `include_domains` 指定官方域名，即可把搜索结果限定在官网内并排除第三方转载。定位到候选公告后，将完整页面 URL 传给 `POST /v1/web/read` 核实原文。

## 域名过滤参数与适用类型

* **`include_domains`**：最多传入 10 个主机域名（例如 `["example.com"]`），不填完整页面路径；需要排除子站或镜像域名时可搭配 `exclude_domains`（同样最多 10 个域名）。
* **适用搜索类型**：`include_domains`、`exclude_domains` 以及时间范围 `time_range`（`day`、`week`、`month`、`year`）仅适用于 `web`（默认）、`news`、`images` 和 `videos`。

```bash
curl -sS https://api.beatapi.io/v1/web/search \
  -H "Authorization: Bearer $BEATAPI_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"query":"ProductX API 停用日期","include_domains":["example.com"],"max_results":5}'
```

## 区分现行公告与历史通知

官网往往同时保留多篇退役公告或更新日志。将筛选出的 `results[].url` 交给 `POST /v1/web/read`，对照 `published_at` 发布日期与 `results[].content` 中的适用版本，区分当前生效通知与历史公告。

## 合同与相关问题

执行前免费检查对应合同：`data:web.search`, `data:web.read`, `data:web.map`。

[返回Web Search问题索引](/zh/faq/web)。