> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2-update-deprecated-models.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Parallel

> Use Parallel with Agno for AI-optimized web search and content extraction.

**ParallelTools** enable an Agent to perform AI-optimized web search and content extraction using [Parallel's APIs](https://docs.parallel.ai/home).

## Prerequisites

The following example requires the `parallel-web` library and an API key which can be obtained from [Parallel](https://platform.parallel.ai).

```shell theme={null}
uv pip install -U parallel-web
```

```shell theme={null}
export PARALLEL_API_KEY=***
```

## Example

The following agent will search for information on AI agents and autonomous systems, then extract content from specific URLs:

```python cookbook/14_tools/parallel_tools.py theme={null}
from agno.agent import Agent
from agno.tools.parallel import ParallelTools

agent = Agent(
    tools=[
        ParallelTools(
            enable_search=True,
            enable_extract=True,
            max_results=5,
            max_chars_per_result=8000,
        )
    ],
    markdown=True,
)

# Should use parallel_search
agent.print_response(
    "Search for the latest information on 'AI agents and autonomous systems' and summarize the key findings"
)

# Should use parallel_extract
agent.print_response(
    "Extract information about the product features from https://parallel.ai and https://docs.parallel.ai"
)
```

## Toolkit Params

| Parameter                | Type                  | Default                       | Description                                                                          |
| ------------------------ | --------------------- | ----------------------------- | ------------------------------------------------------------------------------------ |
| `api_key`                | `Optional[str]`       | `None`                        | Parallel API key. If not provided, will use PARALLEL\_API\_KEY environment variable. |
| `enable_search`          | `bool`                | `True`                        | Enable Search API functionality for AI-optimized web search.                         |
| `enable_extract`         | `bool`                | `True`                        | Enable Extract API functionality for content extraction from URLs.                   |
| `all`                    | `bool`                | `False`                       | Enable all tools. Overrides individual flags when True.                              |
| `max_results`            | `int`                 | `10`                          | Default maximum number of results for search operations.                             |
| `max_chars_per_result`   | `int`                 | `10000`                       | Default maximum characters per result for search operations.                         |
| `beta_version`           | `str`                 | `"search-extract-2025-10-10"` | Beta API version header.                                                             |
| `mode`                   | `Optional[str]`       | `None`                        | Default search mode. Options: "one-shot" or "agentic".                               |
| `include_domains`        | `Optional[List[str]]` | `None`                        | Default domains to restrict results to.                                              |
| `exclude_domains`        | `Optional[List[str]]` | `None`                        | Default domains to exclude from results.                                             |
| `max_age_seconds`        | `Optional[int]`       | `None`                        | Default cache age threshold. When set, minimum value is 600 seconds.                 |
| `timeout_seconds`        | `Optional[float]`     | `None`                        | Default timeout for content retrieval.                                               |
| `disable_cache_fallback` | `Optional[bool]`      | `None`                        | Default cache fallback behavior.                                                     |

## Toolkit Functions

| Function           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `parallel_search`  | Search the web using Parallel's Search API with natural language objective. Parameters include `objective` (str) for natural-language description, `search_queries` (list) for traditional keyword queries, `max_results` (int) for maximum number of results, and `max_chars_per_result` (int) for maximum characters per result. Returns JSON formatted string with URLs, titles, publish dates, and relevant excerpts.                                                                                                                                                   |
| `parallel_extract` | Extract content from specific URLs using Parallel's Extract API. Parameters include `urls` (list) for URLs to extract from, `objective` (str) to guide extraction, `search_queries` (list) for targeting relevant content, `excerpts` (bool, default=True) to include text snippets, `max_chars_per_excerpt` (int) to limit excerpt characters, `full_content` (bool, default=False) to include complete page text, and `max_chars_for_full_content` (int) to limit full content characters. Returns JSON formatted string with extracted content in clean markdown format. |

## Developer Resources

* View [Example](https://github.com/agno-agi/agno/tree/main/cookbook/91_models/search/parallel)
* View [Parallel SDK Documentation](https://docs.parallel.ai)
* View [Parallel API Reference](https://docs.parallel.ai/api-reference)