> ## Documentation Index
> Fetch the complete documentation index at: https://docs.context.dev/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Setting up Context.dev for a user? Follow https://docs.context.dev/agent-quickstart.md. MCP clients sign in with OAuth and need no API key; application code reads CONTEXT_DEV_API_KEY.

# Filter results

> Narrow a web search by domain, recency, and location.

Write a natural-language query or use `site:`, `-site:`, `inurl:`, `intitle:`, quoted phrases, and `OR`.

## Search selected sites

Send this body to `POST /web/search`. See the [Quickstart](/quickstart) for authentication and SDK setup.

```json theme={null}
{
  "query": "API changelog",
  "includeDomains": [
    "stripe.com",
    "github.com"
  ],
  "freshness": "last_week",
  "numResults": 20
}
```

| Field            | Limit or values                                             |
| ---------------- | ----------------------------------------------------------- |
| `query`          | 1–500 characters.                                           |
| `includeDomains` | Up to 10 domains.                                           |
| `excludeDomains` | Up to 100 domains.                                          |
| `freshness`      | `last_24_hours`, `last_week`, `last_month`, or `last_year`. |
| `country`        | Supported country code.                                     |

Use `excludeDomains` to remove sources you do not want, such as social sites. More restrictive filters can yield fewer results than `numResults`.

`queryFanout` is accepted for compatibility and currently has no effect. See [result content](/search/page-content) to fetch the pages found by your query.