A comprehensive collection of practical examples, integration guides, and community showcases for building with Perplexity's Agent API — the new primary API for building hosted agents with native web access, citations, code execution, subagents, and durable, long-running work.
Agent API is now the primary Perplexity API. New projects should build on the Agent API. The Sonar API (
/chat/completions) is deprecated — if you're on Sonar, see the migrate from Sonar guide to move to the Agent API.
🛠️ Examples
Ready-to-run applications demonstrating real-world use cases:
- Equity Research Brief - Agent API +
finance_searchfor ticker-level research briefs - Finance Chart (Sandbox) - Agent API +
finance_search+sandboxto chart a stock's price history - Fact Checker CLI - Verify claims and articles for accuracy
- Daily Knowledge Bot - Automated daily fact delivery system
- Disease Information App - Interactive medical information lookup
- Financial News Tracker - Real-time market analysis
- Academic Research Finder - Literature discovery and summarization
- Discord Bot - Discord integration example
Community-built applications including:
- News and finance apps
- AI-powered search tools
- Browser extensions
- Educational platforms
- And many more innovative projects
In-depth tutorials for advanced implementations:
- Migrating from Sonar to the Agent API
- Memory management patterns
- OpenAI agents integration
- Multi-modal implementations
- Browse the documentation to find examples that match your needs
- Clone this repository and navigate to any example directory
- Follow the setup instructions in each example's README
- Get your API key from Perplexity
- Build and customize for your specific use case
All examples require a Perplexity API key:
export PPLX_API_KEY="your-api-key-here"Get your API key at docs.perplexity.ai.
Have a project built with the Agent API? We'd love to feature it!
This repository syncs to docs.perplexity.ai/cookbook on every commit.
