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

# Perplexity Search

> Give a Hive Agent cross-provider access to Perplexity's standalone Search API

**Perplexity Search** lets a Hive Agent call Perplexity's standalone Search API regardless of whether the agent model is OpenAI, Anthropic, xAI, Gemini, or Perplexity.

The model sees a function named `search_perplexity` and supplies only a required query. All search options are saved on the tool and cannot be overridden by the model.

## Configuration

1. Add **Perplexity Search** from the agent tool selector.
2. Set **Maximum results** from 1 to 20. The default is 10.
3. Choose a country, or **No country restriction**.
4. Choose **Search context size** (`Low`, `Medium`, or `High`), or select **Custom token limits** and set the optional total and per-page token limits. Perplexity does not accept a context preset together with token limits.
5. Optionally select up to 20 search languages.
6. Optionally set updated-after, updated-before, published-after, and published-before dates.
7. Optionally restrict publication recency to the past hour, day, week, month, or year.
8. Choose the agent's credential mode. Hosted mode uses Fetch Hive's key; personal mode requires the workspace's enabled Perplexity integration.

Token limits accept values from 1 to 1,000,000. Date fields are sent to Perplexity in `MM/DD/YYYY` format. For each date window, the **after** date must be earlier than the **before** date.

The tool can be selected at the same time as **Sonar Web Search**. They remain separate tools.

## Result and billing behavior

Each model invocation returns the query and a normalized `results` array. Completed calls render with the standard search-result cards.

Every actual invocation consumes one provider-tool limit unit. If the model never calls the function, no unit is consumed. Successful hosted calls use the fixed Search API cost plus platform markup; successful personal calls use one platform task. Failed calls are not billed.

## Perplexity Search versus Sonar Web Search

* **Perplexity Search** is a standalone API function available across model providers.
* **Sonar Web Search** is native search for Perplexity Sonar agent models.

See also: [Sonar Web Search](./perplexity-search), [Agent tools overview](./overview), and [Agent logs](../../agents/logs)