# Web Search
Some models and systems on Groq have native support for access to real-time web content, allowing them to answer questions with up-to-date information beyond their knowledge cutoff. API responses automatically include citations with a complete list of all sources referenced from the search results.

<br />

Unlike [Browser Search](/docs/browser-search) which mimics human browsing behavior by navigating websites interactively, web search performs a single search and retrieves text snippets from webpages.

## Supported Systems

Built-in web search is supported for the following systems:

| Model ID                        | System                          |
|---------------------------------|--------------------------------|
| groq/compound                   | [Compound](/docs/compound/systems/compound)
| groq/compound-mini              | [Compound Mini](/docs/compound/systems/compound-mini)

<br />

For a comparison between the `groq/compound` and `groq/compound-mini` systems and more information regarding additional capabilities, see the [Compound Systems](/docs/compound/systems#system-comparison) page.

## Quick Start

To use web search, change the `model` parameter to one of the supported models.

*And that's it!*

<br />

When the API is called, it will intelligently decide when to use web search to best answer the user's query. These tool calls are performed on the server side, so no additional setup is required on your part to use built-in tools.


### Final Output

This is the final response from the model, containing the synthesized answer based on web search results. The model combines information from multiple sources to provide a comprehensive response with automatic citations. Use this as the primary output for user-facing applications.

<br />


### Reasoning and Internal Tool Calls

This shows the model's internal reasoning process and the search queries it executed to gather information. You can inspect this to understand how the model approached the problem and what search terms it used. This is useful for debugging and understanding the model's decision-making process.

<br /


### Search Results

These are the raw search results that the model retrieved from the web, including titles, URLs, content snippets, and relevance scores. You can use this data to verify sources, implement custom citation systems, or provide users with direct links to the original content. Each result includes a relevance score from 0 to 1.

<br /


## Search Settings

Customize web search behavior by using the `search_settings` parameter. This parameter allows you to exclude specific domains from search results or restrict searches to only include specific domains. These parameters are supported for both `groq/compound` and `groq/compound-mini`.

| Parameter            | Type            | Description                          |
|----------------------|-----------------|--------------------------------------|
| `exclude_domains`    | `string[]`      | List of domains to exclude when performing web searches. Supports wildcards (e.g., "*.com") |
| `include_domains`    | `string[]`      | Restrict web searches to only search within these specified domains. Supports wildcards (e.g., "*.edu") |
| `country`            | `string`        | Boost search results from a specific country. This will prioritize content from the selected country in the web search results. |

## Pricing

Please see the [Pricing](https://groq.com/pricing) page for more information.

<br />

There are two types of web search: [basic search](#basic-search) and [advanced search](#advanced-search), and these are billed differently.

### Basic Search
A more basic, less comprehensive version of search that provides essential web search capabilities. Basic search is supported on Compound version `2025-07-23`. To use basic search, specify the version in your API request. See [Compound System Versioning](/docs/compound#system-versioning) for details on how to set your Compound version.

### Advanced Search
The default search experience that provides more comprehensive and intelligent search results. Advanced search is automatically used with Compound versions newer than `2025-07-23` and offers enhanced capabilities for better information retrieval and synthesis.

## Provider Information
Web search functionality is powered by [Tavily](https://tavily.com/), a search API optimized for AI applications.
Tavily provides real-time access to web content with intelligent ranking and citation capabilities specifically designed for language models.

---

## Web Search: Countries (ts)