---
project:
  pypi: https://pypi.org/project/strands-perplexity/
  github: https://github.com/mkmeral/strands-perplexity
  maintainer: mkmeral
service:
  name: perplexity
  link: https://docs.perplexity.ai/
title: strands-perplexity
community: true
description: Perplexity web search
integrationType: tool
languages: Python
sidebar:
  label: "perplexity"
---


[strands-perplexity](https://github.com/mkmeral/strands-perplexity) is a real-time web search tool powered by the [Perplexity Search API](https://docs.perplexity.ai/guides/search-quickstart) with citation support, regional filtering, and multi-query capabilities.

## Installation

```bash
pip install strands-perplexity
```

## Usage

```python
from strands import Agent
from strands_perplexity import perplexity_search

agent = Agent(tools=[perplexity_search])

# Search the web
agent("What are the latest developments in AI?")

# Research a topic
agent("Find recent papers on quantum computing breakthroughs")

# Get current information
agent("What happened in tech news today?")
```

## Key Features

- **Real-time Web Search**: Access ranked web search results from Perplexity's continuously refreshed index
- **Citations Included**: Every result includes URLs for proper attribution
- **Regional Search**: Filter results by country using ISO country codes
- **Language Filtering**: Filter results by language using ISO 639-1 codes
- **Domain Filtering**: Include or exclude specific domains from results
- **Multi-query Support**: Execute up to 5 related queries in a single request

## Configuration

```bash
PERPLEXITY_API_KEY=your_api_key    # Required
```

Get your API key at: [Perplexity API Settings](https://perplexity.ai/account/api)

## Resources

- [PyPI Package](https://pypi.org/project/strands-perplexity/)
- [GitHub Repository](https://github.com/mkmeral/strands-perplexity)
- [Perplexity Search API Docs](https://docs.perplexity.ai/guides/search-quickstart)
- [Perplexity Search Best Practices](https://docs.perplexity.ai/guides/search-best-practices)
