# Perplexity (/integrations/perplexity)



{/* MANUAL-CONTENT-START:intro */}

Use [Perplexity](https://www.perplexity.ai) to generate chat responses with web citations or search the web with filtering. Pass the returned content and source references to downstream blocks as needed.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Generate completions using Perplexity AI chat models or perform web searches with advanced filtering.

## Actions [#actions]

### Perplexity Chat [#perplexity-chat]

Generate completions using Perplexity AI chat models

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `systemPrompt` | string | No | System prompt to guide the model behavior |
| `content` | string | Yes | The user message content to send to the model |
| `model` | string | Yes | Model to use for chat completions (e.g., "sonar", "sonar-pro", "sonar-reasoning") |
| `max_tokens` | number | No | Maximum number of tokens to generate (e.g., 1024, 2048, 4096) |
| `temperature` | number | No | Sampling temperature between 0 and 1 (e.g., 0.0 for deterministic, 0.7 for creative) |
| `apiKey` | string | Yes | Perplexity API key |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `content` | string | Generated text content |
| `model` | string | Model used for generation |
| `usage` | object | Token usage information |
| ↳ `prompt_tokens` | number | Number of tokens in the prompt |
| ↳ `completion_tokens` | number | Number of tokens in the completion |
| ↳ `total_tokens` | number | Total number of tokens used |

### Perplexity Search [#perplexity-search]

Get ranked search results from Perplexity's continuously refreshed index with advanced filtering and customization options

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | string | Yes | A search query or array of queries (max 5 for multi-query search) |
| `max_results` | number | No | Maximum number of search results to return (1-20, default: 10) |
| `search_domain_filter` | array | No | List of domains/URLs to limit search results to (e.g., \["github.com", "stackoverflow\.com"], max 20) |
| `max_tokens_per_page` | number | No | Maximum number of tokens retrieved from each webpage (default: 1024) |
| `country` | string | No | Country code to filter search results (e.g., US, GB, DE) |
| `search_recency_filter` | string | No | Filter results by recency (e.g., "hour", "day", "week", "month", "year") |
| `search_after_date` | string | No | Include only content published after this date (format: MM/DD/YYYY) |
| `search_before_date` | string | No | Include only content published before this date (format: MM/DD/YYYY) |
| `apiKey` | string | Yes | Perplexity API key |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `results` | array | Array of search results |
| ↳ `title` | string | Title of the search result |
| ↳ `url` | string | URL of the search result |
| ↳ `snippet` | string | Brief excerpt or summary of the content |
| ↳ `date` | string | Date the page was crawled and added to Perplexity's index |
| ↳ `last_updated` | string | Date the page was last updated in Perplexity's index |