# Perplexity

> Perplexity API documentation for building with the Agent API, the default for web-grounded AI and multi-provider applications, plus Search, Embeddings, and Sonar APIs.

## Docs

- [Overview](https://docs.perplexity.ai/docs/getting-started/overview.md): Perplexity API Platform - build with the Router, Agent, Search, and Embeddings APIs. Real-time, web-wide research and Q&A capabilities for your products.
- [Quickstart](https://docs.perplexity.ai/docs/getting-started/quickstart.md): Generate an API key and make your first call in < 3 minutes.
- [Pricing](https://docs.perplexity.ai/docs/getting-started/pricing.md)
- [Perplexity API MCP Server](https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server.md): Connect AI assistants to Perplexity's search and reasoning capabilities using the Model Context Protocol (MCP).
- [Perplexity Computer MCP Server](https://docs.perplexity.ai/docs/getting-started/integrations/computer-mcp-server.md): Give AI assistants the ability to complete real-world tasks using Perplexity Computer through the Model Context Protocol (MCP).
- [Perplexity CLI](https://docs.perplexity.ai/docs/cli/overview.md): Install and use Perplexity's pplx command-line interface for web search and query-relevant page snippets from your terminal or coding agent.
- [Perplexity Router API](https://docs.perplexity.ai/docs/gateway/quickstart.md): Unified access to open-weight models through OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages APIs, with your Perplexity API key.
- [Router Models & Pricing](https://docs.perplexity.ai/docs/gateway/models.md): The model catalog for the Perplexity Router API, with per-token pricing for Perplexity-hosted and third-party models.
- [Routing & Reliability](https://docs.perplexity.ai/docs/gateway/routing-and-reliability.md): How the Perplexity Router API routes requests across model deployments, and what happens automatically when a provider degrades or fails.
- [Agent API](https://docs.perplexity.ai/docs/agent-api/quickstart.md): The Agent API is a multi-provider, interoperable API specification for building LLM applications. Access models from multiple providers with integrated real-time web search, tool configuration, reasoning control, and token budgets—all through one unified interface.
- [Define the run](https://docs.perplexity.ai/docs/agent-api/building-agents/define-the-run.md): Configure the agent run: start from a preset, then customize the system prompt, the loop bound, and the model.
- [Prompt the agent](https://docs.perplexity.ai/docs/agent-api/building-agents/prompt-the-agent.md): Split the standing rules (the system prompt) from the question (input), and ground the run so the agent searches and answers on the right thing.
- [Give it tools](https://docs.perplexity.ai/docs/agent-api/building-agents/give-it-tools.md): Enable built-in tools and your own custom tools in the tools array, let the model decide when to call them, and read the results back from the response.
- [Run code](https://docs.perplexity.ai/docs/agent-api/building-agents/run-code.md): Give the agent a sandbox so it computes exact answers instead of estimating them, runs real code, and returns generated files.
- [Structure the output](https://docs.perplexity.ai/docs/agent-api/building-agents/shape-output.md): Force the model to return JSON your code can parse instead of prose you have to scrape.
- [Keep context](https://docs.perplexity.ai/docs/agent-api/building-agents/keep-context.md): Carry a conversation across turns by replaying it in the input array, so a follow-up understands what came before.
- [Agent API Models](https://docs.perplexity.ai/docs/agent-api/models.md): Compare third-party and Perplexity models available through the Agent API, including token pricing and provider documentation.
- [Presets](https://docs.perplexity.ai/docs/agent-api/presets.md): Explore Perplexity's Agent API presets - pre-configured setups optimized for different use cases with specific models, search configs, and tool access.
- [Model Fallback](https://docs.perplexity.ai/docs/agent-api/model-fallback.md): Specify multiple models in a fallback chain for higher availability and automatic failover.
- [Tools overview](https://docs.perplexity.ai/docs/agent-api/tools/overview.md): The tools an Agent API run can call - Perplexity-hosted built-in tools, remote MCP servers, and your own custom functions - and where to go for each.
- [Web Search](https://docs.perplexity.ai/docs/agent-api/tools/web-search.md): Search the web from the Agent API with filters, search configurations, pricing, parameters, and response fields.
- [Sandbox](https://docs.perplexity.ai/docs/agent-api/tools/sandbox.md): Execute code in isolated containers from inside an Agent API request.
- [Fetch URL Content](https://docs.perplexity.ai/docs/agent-api/tools/fetch-url-content.md): Fetch and extract content from specific URLs in the Agent API.
- [Finance Search](https://docs.perplexity.ai/docs/agent-api/tools/finance-search.md): Retrieve structured financial and market data in the Agent API.
- [People Search](https://docs.perplexity.ai/docs/agent-api/tools/people-search.md): Search for professionals, employees, and people using People Search in the Agent API
- [MCP](https://docs.perplexity.ai/docs/agent-api/tools/mcp.md): Connect a remote Model Context Protocol (MCP) server to an Agent API request so the model can call your server's tools.
- [Custom Functions](https://docs.perplexity.ai/docs/agent-api/tools/custom-functions.md): Define a custom function, execute model-requested calls in your code, and return each result to the Agent API.
- [Output Control](https://docs.perplexity.ai/docs/agent-api/output-control.md): Streaming and structured outputs for the Agent API
- [Conversation state](https://docs.perplexity.ai/docs/agent-api/conversation-state.md): Continue an Agent API conversation across turns, either by replaying input yourself or by pointing at a completed prior response.
- [Image Attachments](https://docs.perplexity.ai/docs/agent-api/image-attachments.md): Learn how to upload and analyze images using base64 encoding or HTTPS URLs
- [Background Mode](https://docs.perplexity.ai/docs/agent-api/background-mode.md): Run long agentic tasks asynchronously — submit with background, poll by response id, stream, reconnect, and cancel.
- [Working with Files](https://docs.perplexity.ai/docs/agent-api/working-with-files.md): List and download files an Agent API response produced in the sandbox.
- [Skills](https://docs.perplexity.ai/docs/agent-api/skills.md): Give the agent on-demand domain expertise with built-in and inline skills.
- [Wide Research](https://docs.perplexity.ai/docs/agent-api/wide-research.md): Run wide-and-deep research tasks with the wide-research preset — build large, evidence-backed collections in the background.
- [OpenAI Compatibility](https://docs.perplexity.ai/docs/agent-api/openai-compatibility.md): Use your existing OpenAI SDKs with Perplexity's Agent API. Full compatibility with minimal code changes.
- [Migrate from Sonar to the Agent API](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview.md): The Agent API represents a major upgrade of Sonar Chat Completions, bringing added configuration and powerful agentic primitives to your AI applications.
- [How to migrate from Sonar](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/how-to.md): Move a Sonar chat completions integration to the Agent API, including requests, responses, search, presets, async runs, and parameter mappings.
- [Agent API vs Sonar benchmarks](https://docs.perplexity.ai/docs/agent-api/migrate-from-sonar/benchmarks.md): How Agent API presets perform against Sonar across the benchmarks we run, and which preset to use in place of each Sonar model.
- [Prompt Guide](https://docs.perplexity.ai/docs/agent-api/prompt-guide.md): How to write effective prompts for the Agent API.
- [Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart.md): Access real-time web search results with Perplexity's Search API. Get ranked results, domain filtering, multi-query search, and content extraction for developers.
- [Best Practices](https://docs.perplexity.ai/docs/search/best-practices.md): Learn best practices for optimizing search queries and implementing efficient async patterns with Perplexity's Search API.
- [Use Search API with the Anthropic SDK](https://docs.perplexity.ai/docs/search/agent-sdks/anthropic.md): Register Perplexity's Search API as a tool inside the Anthropic Messages API and run the standard tool-use loop with Claude.
- [Use Search API with the OpenAI SDK](https://docs.perplexity.ai/docs/search/agent-sdks/openai.md): Register Perplexity's Search API as a function tool inside the OpenAI Responses API and run the standard tool-call loop with GPT models.
- [Use Search API with the Google Gemini SDK](https://docs.perplexity.ai/docs/search/agent-sdks/gemini.md): Register Perplexity's Search API as a function tool inside Google's google-genai SDK and run the tool-call loop with Gemini models.
- [Search Date and Time Filters](https://docs.perplexity.ai/docs/search/filters/date-time-filters.md)
- [Search Language Filter](https://docs.perplexity.ai/docs/search/filters/language-filter.md)
- [Search Domain Filter](https://docs.perplexity.ai/docs/search/filters/domain-filter.md)
- [People Search](https://docs.perplexity.ai/docs/search/filters/people-search.md)
- [Perplexity Search SDK](https://docs.perplexity.ai/docs/search-sdk/overview.md): An agents-first Python SDK that brings Perplexity's Search as Code approach to your applications: composable retrieval primitives that agents orchestrate in code.
- [Embeddings API](https://docs.perplexity.ai/docs/embeddings/quickstart.md): Generate high-quality text embeddings for semantic search, RAG, and machine learning applications.
- [Best Practices](https://docs.perplexity.ai/docs/embeddings/best-practices.md): Optimize your embeddings workflow with batch processing, caching, RAG patterns, and performance tips.
- [Standard Embeddings](https://docs.perplexity.ai/docs/embeddings/standard-embeddings.md): Generate embeddings for independent texts, search queries, and single sentences.
- [Contextualized Embeddings](https://docs.perplexity.ai/docs/embeddings/contextualized-embeddings.md): Generate document-aware embeddings for chunks that share context, improving retrieval quality for document-based applications.
- [Quickstart](https://docs.perplexity.ai/docs/sdk/overview.md): Learn how to use the official Perplexity SDKs for Python and TypeScript to access the Perplexity APIs with type safety and async support.
- [Configuration](https://docs.perplexity.ai/docs/sdk/configuration.md): Learn how to configure the Perplexity SDKs for retries, timeouts, proxies, and advanced HTTP client customization.
- [Error Handling](https://docs.perplexity.ai/docs/sdk/error-handling.md): Learn how to handle API errors gracefully with the Perplexity SDKs for Python and TypeScript.
- [Performance Optimization](https://docs.perplexity.ai/docs/sdk/performance.md): Learn how to optimize the Perplexity SDKs for high-throughput applications with async support, connection pooling, and raw response access.
- [Type Safety](https://docs.perplexity.ai/docs/sdk/type-safety.md): Learn how to leverage full TypeScript definitions and Python type hints with the Perplexity SDKs for better development experience and code safety.
- [Best Practices](https://docs.perplexity.ai/docs/sdk/best-practices.md): Learn best practices for using the Perplexity SDKs in production, including environment variables, rate limiting, security, and efficient request patterns.
- [Signing In to the API Portal](https://docs.perplexity.ai/docs/admin/signing-in.md): Sign in to the Perplexity API Portal with Google, Apple, single sign-on, or a passwordless email code.
- [API Groups & Billing](https://docs.perplexity.ai/docs/getting-started/api-groups.md): Learn how to use the Perplexity API Portal to manage access, usage, billing, and team collaboration.
- [API Key Management](https://docs.perplexity.ai/docs/admin/api-key-management.md): Learn how to generate, revoke, and rotate API keys for secure access
- [Computer Analytics API](https://docs.perplexity.ai/docs/admin/computer-analytics-api.md): Query your organization's Computer usage analytics programmatically with a free, org-scoped API key
- [Rate Limits & Usage Tiers](https://docs.perplexity.ai/docs/admin/rate-limits-usage-tiers.md)
- [AWS Marketplace](https://docs.perplexity.ai/docs/resources/aws-marketplace.md): Subscribe to the Perplexity API Platform through AWS Marketplace for consolidated billing and enterprise procurement.
- [Perplexity with AG2](https://docs.perplexity.ai/docs/getting-started/integrations/ag2.md): Use the Perplexity Search API as a tool inside AG2 (AutoGen) agents.
- [Perplexity with Agno](https://docs.perplexity.ai/docs/getting-started/integrations/agno.md): Use Perplexity's Agent API through Agno's OpenAI Responses integration.
- [Perplexity with Google Antigravity](https://docs.perplexity.ai/docs/getting-started/integrations/antigravity.md): Call Perplexity's Agent API from applications you build or edit inside Google Antigravity.
- [Perplexity with AnythingLLM](https://docs.perplexity.ai/docs/getting-started/integrations/anythingllm.md): Use Perplexity as the LLM provider in AnythingLLM for grounded, citation-backed chat over your documents and workspaces.
- [Perplexity with CAMEL-AI](https://docs.perplexity.ai/docs/getting-started/integrations/camel.md): Use the Perplexity Search API as a tool inside CAMEL-AI multi-agent systems.
- [Perplexity with Claude Code](https://docs.perplexity.ai/docs/getting-started/integrations/claude-code.md): Use Perplexity inside Claude Code — call the API from project code with the official TypeScript SDK, use the OpenAI-compatible base URL, or wire up the hosted Perplexity Docs MCP for in-editor documentation lookup.
- [Perplexity with Composio](https://docs.perplexity.ai/docs/getting-started/integrations/composio.md): Expose Perplexity's Agent, Search, and Embeddings APIs as MCP tools or direct API actions for any AI agent framework via Composio.
- [Perplexity with Cursor](https://docs.perplexity.ai/docs/getting-started/integrations/cursor.md): Use Perplexity inside Cursor — call the API from project code with the official TypeScript SDK, use the OpenAI-compatible base URL, or wire up the hosted Perplexity Docs MCP for in-editor documentation lookup.
- [Perplexity with Haystack](https://docs.perplexity.ai/docs/getting-started/integrations/haystack.md): Use Perplexity's Agent API, Embeddings API, and grounded Search API in Haystack pipelines.
- [Perplexity with LangChain](https://docs.perplexity.ai/docs/getting-started/integrations/langchain.md): Call Perplexity's Agent API from LangChain and LangGraph through langchain-openai's Responses support.
- [Perplexity with LiteLLM](https://docs.perplexity.ai/docs/getting-started/integrations/litellm.md): Use Perplexity's Agent API and presets through LiteLLM's unified interface — Python SDK and Proxy.
- [Perplexity with LiveKit Agents](https://docs.perplexity.ai/docs/getting-started/integrations/livekit.md): Use Perplexity's Agent API as the LLM brain of a LiveKit voice agent.
- [Perplexity with Mastra](https://docs.perplexity.ai/docs/getting-started/integrations/mastra.md): Use Perplexity's Agent API and the Search API in your Mastra agents and tools.
- [Perplexity with n8n](https://docs.perplexity.ai/docs/getting-started/integrations/n8n.md): Add real-time web search, AI agents, and embeddings to your n8n workflows using the native Perplexity node.
- [Perplexity with OpenClaw](https://docs.perplexity.ai/docs/getting-started/integrations/openclaw.md): Use Perplexity as an LLM provider and web search provider in OpenClaw.
- [Perplexity with OpenCode](https://docs.perplexity.ai/docs/getting-started/integrations/opencode.md): Use the Perplexity Agent API inside the OpenCode AI coding agent — one endpoint, every frontier model, one API key.
- [Perplexity with Pipedream](https://docs.perplexity.ai/docs/getting-started/integrations/pipedream.md): Wire Perplexity into Pipedream workflows alongside 3,000+ other apps — automate research, summarization, and grounded responses with code and no-code steps.
- [Perplexity with SuperPlane](https://docs.perplexity.ai/docs/getting-started/integrations/superplane.md): Run Perplexity agents inside SuperPlane workflows — research, synthesis, and analysis steps with web search, URL fetching, and source citations.
- [Perplexity with the Vercel AI SDK](https://docs.perplexity.ai/docs/getting-started/integrations/vercel-ai-sdk.md): Use Perplexity's Agent API from Vercel AI SDK (Next.js) apps through the @ai-sdk/open-responses provider.
- [API Roadmap](https://docs.perplexity.ai/docs/resources/feature-roadmap.md): Upcoming and in-progress features for the Perplexity API.
- [Privacy & Security](https://docs.perplexity.ai/docs/resources/privacy-security.md): Learn about Perplexity's data privacy, retention policies, and security certifications for API users
- [Frequently Asked Questions](https://docs.perplexity.ai/docs/resources/faq.md): Answers to common questions about the Perplexity API, covering models, output and capabilities, search behavior, billing and limits, errors, data privacy, and support.
- [System Status](https://docs.perplexity.ai/docs/resources/status.md)
- [Changelog](https://docs.perplexity.ai/docs/resources/changelog.md)
- [Get in Touch](https://docs.perplexity.ai/docs/resources/discussions.md)
- [Perplexity Crawlers](https://docs.perplexity.ai/docs/resources/perplexity-crawlers.md): We strive to improve our service every day by delivering the best search experience possible. To achieve this, we collect data using web crawlers ("robots") and user agents that gather and index information from the internet, operating either automatically or in response to user requests. Webmasters…
- [Sonar API](https://docs.perplexity.ai/docs/sonar/quickstart.md): Get started with Perplexity's Sonar API for web-grounded AI responses. Make your first API call in minutes.
- [Models](https://docs.perplexity.ai/docs/sonar/models.md): Compare Sonar, Sonar Pro, Sonar Reasoning Pro, and Sonar Deep Research models for the Sonar API.
- [Sonar](https://docs.perplexity.ai/docs/sonar/models/sonar.md): Learn about the Sonar search model, including its pricing, API usage, and best-fit use cases.
- [Sonar Pro](https://docs.perplexity.ai/docs/sonar/models/sonar-pro.md): Learn about Sonar Pro for advanced search, including pricing, API usage, and Pro Search support.
- [Sonar Reasoning Pro](https://docs.perplexity.ai/docs/sonar/models/sonar-reasoning-pro.md): Learn about Sonar Reasoning Pro for advanced multi-step reasoning, including pricing and API usage.
- [Sonar Deep Research](https://docs.perplexity.ai/docs/sonar/models/sonar-deep-research.md): Learn about Sonar Deep Research for exhaustive research workflows, including pricing and API usage.
- [Prompt Guide](https://docs.perplexity.ai/docs/sonar/prompt-guide.md): Sonar-specific prompting guidance and how it differs from the Agent API.
- [Core Features](https://docs.perplexity.ai/docs/sonar/features.md): Streaming and structured outputs for the Sonar API
- [Search Filters](https://docs.perplexity.ai/docs/sonar/filters.md): Control and customize Sonar API search results with filters
- [Media & Attachments](https://docs.perplexity.ai/docs/sonar/media.md): Send and receive images, videos, and files with the Sonar API
- [Quickstart](https://docs.perplexity.ai/docs/sonar/pro-search/quickstart.md): Get started with Pro Search for Sonar Pro - enhanced search with automated tools, multi-step reasoning, and real-time thought streaming
- [Built-in Tool Capabilities](https://docs.perplexity.ai/docs/sonar/pro-search/tools.md): Learn about Pro Search's built-in tools: web search and URL content fetching
- [Stream Mode: Concise vs Full](https://docs.perplexity.ai/docs/sonar/pro-search/stream-mode.md): Learn how to use stream_mode to control streaming response formats and optimize your integration
- [Pro Search Classifier](https://docs.perplexity.ai/docs/sonar/pro-search/classifier.md): Optimize cost and performance with automatic query classification between Pro Search and Fast Search modes
- [OpenAI SDK Compatibility](https://docs.perplexity.ai/docs/sonar/openai-compatibility.md): Use OpenAI SDKs with the Sonar API by changing the base URL and API key
- [Cookbook](https://docs.perplexity.ai/docs/cookbook/index.md): Guides, runnable examples, and community projects for building with the Perplexity Agent, Search, and Embeddings APIs. Search or filter by product and category.
- [Getting Started](https://docs.perplexity.ai/docs/cookbook/getting-started.md): How to use the Perplexity API Cookbook, plus a quick start for getting your API key and installing the SDK.
- [Briefo | Perplexity Powered News & Finance Social App](https://docs.perplexity.ai/docs/cookbook/showcase/briefo.md): AI curated newsfeed, social discussion, and deep research reports built on the Sonar API
- [CityPulse | AI-Powered Geospatial Discovery Search](https://docs.perplexity.ai/docs/cookbook/showcase/citypulse-ai-search.md): Real-time local discovery search using Perplexity AI for personalized location insights and recommendations
- [Fact Dynamics | Real-time Fact-Checking Flutter App](https://docs.perplexity.ai/docs/cookbook/showcase/fact-dynamics.md): Cross-platform app for real-time fact-checking of debates, speeches, and images using Perplexity's Sonar API
- [Perplexity Dart & Flutter SDKs](https://docs.perplexity.ai/docs/cookbook/showcase/perplexity-flutter.md): Lightweight, type-safe SDKs for seamless Perplexity API integration in Dart and Flutter applications
- [PerplexiGrid | Interactive Analytics Dashboards](https://docs.perplexity.ai/docs/cookbook/showcase/perplexigrid.md): Instantly generate analytics dashboards from natural language using live data via Perplexity Sonar API.
- [Valetudo AI | Trusted Medical Answer Assistant](https://docs.perplexity.ai/docs/cookbook/showcase/valetudo-ai.md): Sonar-powered medical assistant for fast, science-backed answers.
- [CycleSyncAI | Personalized Health Plans Powered by Sonar API](https://docs.perplexity.ai/docs/cookbook/showcase/cycle-sync-ai.md): iOS app that delivers personalized diet and workout recommendations for women, powered by Apple HealthKit and Perplexity's Sonar Pro API.
- [FlameGuardAI | AI-powered wildfire prevention](https://docs.perplexity.ai/docs/cookbook/showcase/flameguardai.md): AI-powered wildfire prevention using OpenAI Vision + Perplexity Sonar API
- [Monday – Voice-First AI Learning Assistant](https://docs.perplexity.ai/docs/cookbook/showcase/monday.md): An accessible, multimodal AI learning companion that delivers contextual reasoning, 3D visualizations, and curated educational content via natural voice interaction.
- [Ellipsis | One-Click Podcast Generation Agent](https://docs.perplexity.ai/docs/cookbook/showcase/Ellipsis.md): A next-gen podcast generation agent that brings human-like, high-quality audio content to life on any topic with just one click
- [FirstPrinciples | AI Learning Roadmap Generator](https://docs.perplexity.ai/docs/cookbook/showcase/first-principle.md): An AI-powered learning roadmap generator that uses conversational AI to help users identify specific learning topics and provides personalized step-by-step learning plans
- [BazaarAISaathi | AI-Powered Indian Stock Market Assistant](https://docs.perplexity.ai/docs/cookbook/showcase/bazaar-ai-saathi.md): An AI-powered platform for Indian stock market analysis, portfolio optimization, and investment strategies using Perplexity Sonar API
- [4Point Hoops | AI Basketball Analytics Platform](https://docs.perplexity.ai/docs/cookbook/showcase/4point-Hoops.md): Advanced NBA analytics platform that combines live Basketball-Reference data with Perplexity Sonar to deliver deep-dive player stats, cross-season comparisons and expert-grade AI explanations
- [MVP LifeLine | AI Youth Empowerment Platform](https://docs.perplexity.ai/docs/cookbook/showcase/mvp-lifeline-ai-app.md): A multilingual, offline-first AI platform that helps underserved youth Earn, Heal, and Grow using real-time AI and holistic tools
- [Executive Intelligence | AI-Powered Strategic Decision Platform](https://docs.perplexity.ai/docs/cookbook/showcase/executive-intelligence.md): A comprehensive Perplexity Sonar-powered application that provides executives and board members with instant, accurate, and credible intelligence for strategic decision-making
- [Flow & Focus | Personalized News for Genuine Understanding](https://docs.perplexity.ai/docs/cookbook/showcase/flow-and-focus.md): A personalized news app combining vertical feed discovery with AI-powered deep dives using Perplexity Sonar Pro and Deep Research models
- [Perplexity Lens | AI-Powered Knowledge Graph Browser Extension](https://docs.perplexity.ai/docs/cookbook/showcase/perplexity-lens.md): A browser extension that builds personalized knowledge graphs using Perplexity AI for smart text selection, webpage summarization, and contextual insights
- [Greenify | Localized community-driven greenification/plantation solution with AI](https://docs.perplexity.ai/docs/cookbook/showcase/greenify.md): A mobile application that analyzes photos and location data to suggest suitable plants and build sustainable communities using Perplexity Sonar API
- [Sonar Chromium Browser | Native Search Omnibox and Context Menu](https://docs.perplexity.ai/docs/cookbook/showcase/sonar-chromium-browser.md): Chromium browser patch with native Perplexity Sonar API integration providing omnibox answers and context-menu summarization
- [PosterLens | Scientific Poster Scanner & Research Assistant](https://docs.perplexity.ai/docs/cookbook/showcase/posterlens.md): An iOS app that transforms static scientific posters into interactive insights using OCR and Perplexity's Sonar Pro API for semantic search and context
- [Daily News Briefing | AI-Powered News Summaries for Obsidian](https://docs.perplexity.ai/docs/cookbook/showcase/daily-news-briefing.md): An Obsidian plugin that delivers AI-powered daily news summaries directly to your vault using Perplexity's Sonar API for intelligent content curation
- [UnCovered | Real-Time Fact-Checking Chrome Extension](https://docs.perplexity.ai/docs/cookbook/showcase/uncovered.md): A Chrome extension that brings real-time fact-checking to anything you see online in just 2 clicks, powered by Perplexity's Sonar API for instant verification
- [PerplexiCart | AI-Powered Value-Aligned Shopping Assistant](https://docs.perplexity.ai/docs/cookbook/showcase/perplexicart.md): An AI shopping assistant that uses Perplexity Sonar to deliver structured research, value-aligned recommendations, and transparent citations across the web
- [TruthTracer | AI-Powered Misinformation Detection Platform](https://docs.perplexity.ai/docs/cookbook/showcase/truth-tracer.md): A comprehensive misinformation detection platform that uses Perplexity's Sonar API to analyze claims, trace trust chains, and provide Socratic reasoning for fact verification
- [StarPlex | AI-Powered Startup Intelligence Platform](https://docs.perplexity.ai/docs/cookbook/showcase/starplex.md): An AI-powered startup intelligence platform that helps entrepreneurs validate their business ideas and find the right resources to succeed
- [Perplexity Client | Desktop AI Chat Interface with API Controls](https://docs.perplexity.ai/docs/cookbook/showcase/perplexity-client.md): An Electron-based desktop client for Perplexity API with advanced features like model selection, custom system prompts, and API debugging mode
- [Examples Overview](https://docs.perplexity.ai/docs/cookbook/examples/README.md): Runnable projects covering the Agent API, Search API, and Embeddings API
- [Fact Checker CLI](https://docs.perplexity.ai/docs/cookbook/examples/fact-checker-cli/README.md): A command-line tool that identifies false or misleading claims in articles or statements using Perplexity's Sonar API
- [Daily Knowledge Bot](https://docs.perplexity.ai/docs/cookbook/examples/daily-knowledge-bot/README.md): A Python application that delivers interesting facts about rotating topics using the Perplexity AI API
- [Disease Information App](https://docs.perplexity.ai/docs/cookbook/examples/disease-qa/README.md): An interactive browser-based application that provides structured information about diseases using Perplexity's Sonar API
- [Academic Research Finder CLI](https://docs.perplexity.ai/docs/cookbook/examples/research-finder/README.md): A command-line tool that uses Perplexity's Sonar API to find and summarize academic literature
- [Perplexity Discord Bot](https://docs.perplexity.ai/docs/cookbook/examples/discord-py-bot/README.md): A simple discord.py bot that integrates Perplexity's Sonar API to bring AI answers to your Discord server.
- [Financial News Tracker](https://docs.perplexity.ai/docs/cookbook/examples/financial-news-tracker/README.md): A real-time financial news monitoring tool that fetches and analyzes market news using Perplexity's Sonar API
- [Document Q&A with Embeddings](https://docs.perplexity.ai/docs/cookbook/examples/document-qa/README.md): A self-contained RAG system that ingests documents, generates contextualized embeddings, and answers questions using the Agent API
- [Agent Research Assistant](https://docs.perplexity.ai/docs/cookbook/examples/agent-research-assistant/README.md): A CLI tool that uses Perplexity's Agent API with the medium preset to conduct multi-step web research and produce structured reports
- [Equity Research Brief](https://docs.perplexity.ai/docs/cookbook/examples/equity-research-brief/README.md): Generate institutional-grade equity research briefs from any public ticker using the Perplexity Agent API and the built-in finance_search tool.
- [TypeScript Agent CLI](https://docs.perplexity.ai/docs/cookbook/examples/typescript-agent-cli/README.md): An interactive TypeScript CLI with streaming responses, model selection, and web search using the Perplexity Agent API
- [Image Analysis](https://docs.perplexity.ai/docs/cookbook/examples/image-analysis/README.md): Vision-powered image analysis with web search for context-enriched results using the Perplexity Agent API
- [Multi-Provider Model Comparison](https://docs.perplexity.ai/docs/cookbook/examples/model-comparison/README.md): A CLI tool that sends the same prompt to multiple AI models via Perplexity's Agent API and compares response quality, latency, and cost
- [Document Q&A](https://docs.perplexity.ai/docs/cookbook/examples/file-attachment-qa/README.md): Load documents and ask questions about them via the Agent API — text extraction, web search enrichment, multi-turn Q&A, and structured output extraction
- [Search News Monitor](https://docs.perplexity.ai/docs/cookbook/examples/search-news-monitor/README.md): A CLI tool that uses Perplexity's Search API to monitor real-time news across multiple configurable topics with domain and recency filtering
- [SEC Filing Search](https://docs.perplexity.ai/docs/cookbook/examples/sec-filing-search/README.md): Use search domain filtering to query SEC.gov and EDGAR for financial filings, extract key financial data, and build structured financial summaries
- [Competitor Buzz Tracker](https://docs.perplexity.ai/docs/cookbook/examples/competitor-buzz-tracker/README.md): Turn a basket of searches and keyword rules into a one-page share-of-voice chart (PDF) with two chained Agent API requests. The first searches and counts inside the sandbox and returns a structured-output JSON contract. The second renders the bar chart and shares it as a downloadable file.
- [Talent Sourcer](https://docs.perplexity.ai/docs/cookbook/examples/talent-sourcer/README.md): Build a vetted engineer sourcing shortlist with one Agent API request. The model works in a Python sandbox - segmenting the brief, calling people_search across sub-segments, verifying each candidate's role, location, and tenure with web_search, collecting GitHub, social, and publication links, scori…
- [Model Picker](https://docs.perplexity.ai/docs/cookbook/examples/model-picker/README.md): Describe a task and get a grounded shortlist of open models to use. One Agent API request combines the Hugging Face MCP server with web search to find, verify, and recommend a model.
- [Grounded Data Story with Kimi K3](https://docs.perplexity.ai/docs/cookbook/examples/data-story-kimi-k3/README.md): Turn any topic into a self-contained, source-linked interactive HTML report using Kimi K3, live web search, and the Agent API.
- [Chat Summary Memory Buffer](https://docs.perplexity.ai/docs/cookbook/articles/memory-management/chat-summary-memory-buffer/README.md): Token-aware conversation memory using summarization with LlamaIndex and Perplexity Sonar API
- [OpenAI Agents Integration](https://docs.perplexity.ai/docs/cookbook/articles/openai-agents-integration/README.md): Complete guide for integrating Perplexity's Sonar API with the OpenAI Agents SDK
- [Memory Management](https://docs.perplexity.ai/docs/cookbook/articles/memory-management/README.md): Advanced conversation memory solutions using LlamaIndex for persistent, context-aware applications
- [Persistent Chat Memory](https://docs.perplexity.ai/docs/cookbook/articles/memory-management/chat-with-persistence/README.md): Long-term conversation memory using LanceDB vector storage and Perplexity Sonar API
- [RAG with Perplexity Embeddings](https://docs.perplexity.ai/docs/cookbook/articles/embeddings-rag/README.md): Build an end-to-end retrieval-augmented generation pipeline using Perplexity's standard and contextualized embedding models.
- [Streaming Citation Parsing](https://docs.perplexity.ai/docs/cookbook/articles/streaming-citations/README.md): Consume streaming responses from the Agent API and extract, validate, and display citations in real-time as chunks arrive
- [Structured Output Extraction](https://docs.perplexity.ai/docs/cookbook/articles/structured-output-extraction/README.md): Get typed, schema-validated JSON responses from the Agent API using response_format with JSON schemas for data extraction, pipelines, and structured research
- [Multi-Provider Orchestration](https://docs.perplexity.ai/docs/cookbook/articles/multi-provider-orchestration/README.md): Route between OpenAI, Anthropic, Google, and xAI models through Perplexity's Agent API with zero markup, build fallback chains, and compare providers side-by-side
- [Academic and Scholarly Search](https://docs.perplexity.ai/docs/cookbook/articles/academic-search/README.md): Use the Agent API's domain filtering to restrict search to academic sources, extract DOIs and paper metadata, build citation chains, and create research summaries with proper attribution
- [Deep Research Workflows](https://docs.perplexity.ai/docs/cookbook/articles/async-deep-research/README.md): Use the Agent API medium preset for comprehensive, multi-step research tasks — synchronous usage, batch concurrency, result processing, and production patterns
- [Search Domain Filtering Patterns](https://docs.perplexity.ai/docs/cookbook/articles/search-domain-filtering/README.md): Use search_domain_filter for focused search — allowlist patterns for trusted sources, denylist for excluding domains, and practical patterns for news, government, and competitive intelligence
- [VC Investment Memo Agent with LangGraph](https://docs.perplexity.ai/docs/cookbook/articles/langchain-vc-memo-agent/README.md): Build an auditable, citation-grounded VC research agent with LangGraph and the Perplexity Agent API, and pick the best search provider with a LangSmith eval harness.
- [Daily AI Stock News PDF with Skills](https://docs.perplexity.ai/docs/cookbook/articles/agent-skills/README.md): Generate a daily one-page AI-industry stock news PDF with the Agent API using the built-in office skill and an inline design skill.
- [Daily News Digest with LLM Deduplication](https://docs.perplexity.ai/docs/cookbook/articles/news-dedupe-digest/README.md): Build a daily news digest that reports each story once. One Agent API request runs code in the sandbox to fetch the day's news, groups coverage into stories, and delivers the digest and a story registry as files.
- [Function Calling End-to-End](https://docs.perplexity.ai/docs/cookbook/articles/function-calling-e2e/README.md): Complete multi-turn function calling patterns for the Perplexity Agent API, including orchestration, web search integration, error handling, and parallel calls
- [Create Chat Completion](https://docs.perplexity.ai/api-reference/gateway-chat-completions-post.md): Send a conversation to any Router model using the OpenAI Chat Completions schema. Set `stream: true` to receive server-sent events; add `stream_options: {"include_usage": true}` to get token usage in the final chunk.
- [Create Response](https://docs.perplexity.ai/api-reference/gateway-responses-post.md): Generate a model response using the OpenAI Responses schema. Set `stream: true` to receive typed server-sent events followed by `data: [DONE]`.
- [Create Message](https://docs.perplexity.ai/api-reference/gateway-messages-post.md): Send a conversation to any Router model using the Anthropic Messages schema. Set `stream: true` to receive server-sent events. Authenticate with your Perplexity API key — both `Authorization: Bearer` and the Anthropic SDK's default `x-api-key` header are accepted.
- [List Models](https://docs.perplexity.ai/api-reference/gateway-models-get.md): List the models available through the Router, sorted by id. Each model includes its base token prices in `pricing` (USD per 1M tokens).
- [Retrieve Model](https://docs.perplexity.ai/api-reference/gateway-model-get.md): Retrieve one model by id, including its base token prices. Model ids contain a `/` (for example `perplexity/kimi-k3`); pass the full id in the path.
- [Create Agent Response](https://docs.perplexity.ai/api-reference/agent-post.md): Generate a response for the provided input with optional web search and reasoning.
- [Retrieve Agent Response](https://docs.perplexity.ai/api-reference/agent-get.md): Retrieve a response created earlier. Returns a JSON snapshot of the response. Only responses created with `store` omitted or `true` can be retrieved; `store: false` responses return a 404.
- [List Agent Response Files](https://docs.perplexity.ai/api-reference/agent-files-get.md): List the files a response produced in the sandbox and delivered with the `share_file` tool. Scoped to the authenticated account, which only ever sees its own files. File content is not returned inline; download it with the file content endpoint.
- [Download Agent Response File](https://docs.perplexity.ai/api-reference/agent-file-content-get.md): Download the raw bytes of a file the response delivered with the `share_file` tool. The `file_id` comes from the file list endpoint and is distinct from the response `id`. The response streams raw bytes, not JSON, with a `Content-Type` matching the file and a `Content-Disposition: attachment` header…
- [Cancel Agent Response](https://docs.perplexity.ai/api-reference/agent-cancel-post.md): Requests cancellation of response `{id}`. Acts on durable state, so it works for background runs that outlive the client connection. Cancellation is asynchronous: a `200` acknowledges the request (`status: cancelling`) and the run stops shortly after - poll `GET /v1/agent/{id}` for its terminal stat…
- [List Models](https://docs.perplexity.ai/api-reference/models-get.md): List the models available for the Agent API. Returns model identifiers that can be used with the `POST /v1/agent` endpoint. The response follows the OpenAI List Models format for compatibility with third-party tools.
- [Search the Web](https://docs.perplexity.ai/api-reference/search-post.md): Search the web and retrieve relevant web page contents.
- [Create Embeddings](https://docs.perplexity.ai/api-reference/embeddings-post.md): Generate embeddings for a list of texts. Use these embeddings for semantic search, clustering, and other machine learning applications.
- [Create Contextualized Embeddings](https://docs.perplexity.ai/api-reference/contextualized-embeddings-post.md): Generate contextualized embeddings for document chunks. Chunks from the same document share context awareness, improving retrieval quality for document-based applications.
- [Create Chat Completion](https://docs.perplexity.ai/api-reference/sonar-post.md): Generate a chat completion response for the given conversation.
- [Create Async Chat Completion](https://docs.perplexity.ai/api-reference/async-sonar-post.md): Submit an asynchronous chat completion request.
- [List Async Chat Completions](https://docs.perplexity.ai/api-reference/async-sonar-get.md): Retrieve a list of all asynchronous chat completion requests for a given user.
- [Get Async Chat Completion](https://docs.perplexity.ai/api-reference/async-sonar-api-request-get.md): Retrieve the response for a given asynchronous chat completion request.
- [Generate Auth Token](https://docs.perplexity.ai/api-reference/generate-auth-token-post.md): Generates a new authentication token for API access.
- [Revoke Auth Token](https://docs.perplexity.ai/api-reference/revoke-auth-token-post.md): Revokes an existing authentication token.
- [Computer Usage Analytics](https://docs.perplexity.ai/api-reference/computer-analytics-usage-get.md): Returns your organization's Computer usage analytics as a bucketed time series for a single dataset. Requires an organization analytics API key, generated by an org admin from Settings → Organization → Computer in the Perplexity web app. Only complete UTC grid buckets are returned: start_time snaps…
- [Computer Usage Analytics per Member](https://docs.perplexity.ai/api-reference/computer-analytics-usage-v2-get.md): Returns your organization's Computer credit usage broken down per member, as daily buckets. Each day lists one row per member who used credits that day, keyed by email, with the same Model and Credit Source breakdown as v1. Uses the same organization analytics API key as v1. Only complete UTC days a…

## OpenAPI Specs

- [openapi-gateway-responses](https://docs.perplexity.ai/openapi-gateway-responses.json)
- [openapi-gateway-messages](https://docs.perplexity.ai/openapi-gateway-messages.json)
- [openapi-gateway-chat](https://docs.perplexity.ai/openapi-gateway-chat.json)
- [openapi](https://docs.perplexity.ai/openapi.json)
- [openapi-auth](https://docs.perplexity.ai/openapi-auth.json)

## Optional

- [Community](https://community.perplexity.ai)
- [Blog](https://research.perplexity.ai/articles)