> 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.

# How do I search only an official website rather than reposts?

> Pass up to 10 official domains in include_domains on POST /v1/web/search (for web, news, images, or videos) to filter out third-party reposts, then verify candidate URLs with POST /v1/web/read.

Pass the official hostnames in `include_domains` on `POST /v1/web/search` to restrict results to the primary domain and exclude third-party reposts. Once Search locates candidate official notices, pass each full URL to `POST /v1/web/read` to confirm exact wording.

## Domain filter parameters and supported types

* **`include_domains`**: Array of up to 10 domains (for example `["example.com"]`), not full page paths. Pair with `exclude_domains` (up to 10 domains) when filtering out subdomains or mirrors.
* **Supported search types**: `include_domains`, `exclude_domains`, and `time_range` (`day`, `week`, `month`, `year`) apply to `web` (default), `news`, `images`, and `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 retirement date","include_domains":["example.com"],"max_results":5}'
```

## Distinguish current notices from historical posts

Official sites frequently host multiple deprecation or changelog pages. Pass the shortlisted `results[].url` values to `POST /v1/web/read`, then compare publication dates (`published_at`) and affected versions in `results[].content` to separate the active notice from superseded announcements.

## Contracts and related questions

Before running a request, inspect the contract for free: `data:web.search`, `data:web.read`, `data:web.map`.

[Back to Web Search questions](/faq/web).