# Perplexity

## Docs

- [Overview](https://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/overview.md)
- [Quickstart](https://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/quickstart.md): Generate an API key and make your first call in < 3 minutes.
- [Pricing](https://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/pricing.md)
- [Perplexity MCP Server](https://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/integrations/mcp-server.md): Connect AI assistants to Perplexity's search and reasoning capabilities using the Model Context Protocol (MCP).
- [Perplexity with LangChain](https://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/integrations/langchain.md): Use Perplexity's chat models and search tool in your LangChain applications.
- [Quickstart](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/sdk/configuration.md): Learn how to configure the Perplexity SDKs for retries, timeouts, proxies, and advanced HTTP client customization.
- [Error Handling](https://perplexity-cf-proxied-beta.mintlify.site/docs/sdk/error-handling.md): Learn how to handle API errors gracefully with the Perplexity SDKs for Python and Typescript.
- [Performance Optimization](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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.
- [Agent API](https://perplexity-cf-proxied-beta.mintlify.site/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.
- [Models](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/models.md): Explore available presets and third-party models for the Agent API, including Perplexity presets and third-party model support.
- [Presets](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/presets.md): Explore Perplexity's Agent API presets - pre-configured setups optimized for different use cases with specific models, token limits, and tool access.
- [Model Fallback](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/model-fallback.md): Specify multiple models in a fallback chain for higher availability and automatic failover.
- [Tools](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/tools.md): Web search, URL fetching, and function calling tools for the Agent API
- [Output Control](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/output-control.md): Streaming and structured outputs for the Agent API
- [Search Filters](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/filters.md): Control and customize Agent API search results with filters
- [Image Attachments](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/image-attachments.md): Learn how to upload and analyze images using base64 encoding or HTTPS URLs
- [Prompt Guide](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/prompt-guide.md)
- [OpenAI Compatibility](https://perplexity-cf-proxied-beta.mintlify.site/docs/agent-api/openai-compatibility.md): Use your existing OpenAI SDKs with Perplexity's Agent API. Full compatibility with minimal code changes.
- [Perplexity Search API](https://perplexity-cf-proxied-beta.mintlify.site/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.
- [Search Date and Time Filters](https://perplexity-cf-proxied-beta.mintlify.site/docs/search/filters/date-time-filters.md)
- [Search Language Filter](https://perplexity-cf-proxied-beta.mintlify.site/docs/search/filters/language-filter.md)
- [Search Domain Filter](https://perplexity-cf-proxied-beta.mintlify.site/docs/search/filters/domain-filter.md)
- [Best Practices](https://perplexity-cf-proxied-beta.mintlify.site/docs/search/best-practices.md): Learn best practices for optimizing search queries and implementing efficient async patterns with Perplexity's Search API.
- [Sonar API](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/getting-started/models.md)
- [Core Features](https://perplexity-cf-proxied-beta.mintlify.site/docs/sonar/features.md): Streaming, structured outputs, and prompting best practices for the Sonar API
- [Search Filters](https://perplexity-cf-proxied-beta.mintlify.site/docs/sonar/filters.md): Control and customize Sonar API search results with filters
- [Media & Attachments](https://perplexity-cf-proxied-beta.mintlify.site/docs/sonar/media.md): Send and receive images, videos, and files with the Sonar API
- [Quickstart](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/sonar/openai-compatibility.md): Use OpenAI SDKs with the Sonar API by changing the base URL and API key
- [Browser](https://perplexity-cf-proxied-beta.mintlify.site/docs/browser/quickstart.md): Remote browser automation via Chrome DevTools Protocol (CDP) with Playwright or any CDP client.
- [Embeddings API](https://perplexity-cf-proxied-beta.mintlify.site/docs/embeddings/quickstart.md): Generate high-quality text embeddings for semantic search, RAG, and machine learning applications.
- [Standard Embeddings](https://perplexity-cf-proxied-beta.mintlify.site/docs/embeddings/standard-embeddings.md): Generate embeddings for independent texts, search queries, and single sentences.
- [Contextualized Embeddings](https://perplexity-cf-proxied-beta.mintlify.site/docs/embeddings/contextualized-embeddings.md): Generate document-aware embeddings for chunks that share context, improving retrieval quality for document-based applications.
- [Best Practices](https://perplexity-cf-proxied-beta.mintlify.site/docs/embeddings/best-practices.md): Optimize your embeddings workflow with batch processing, caching, RAG patterns, and performance tips.
- [API Groups & Billing](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/admin/api-key-management.md): Learn how to generate, revoke, and rotate API keys for secure access
- [Rate Limits & Usage Tiers](https://perplexity-cf-proxied-beta.mintlify.site/docs/admin/rate-limits-usage-tiers.md)
- [API Roadmap](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/feature-roadmap.md): Upcoming features and improvements for the Perplexity API designed to enhance your development experience.
- [Privacy & Security](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/privacy-security.md): Learn about Perplexity's data privacy, retention policies, and security certifications for API users
- [Frequently Asked Questions](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/faq.md)
- [System Status](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/status.md)
- [Changelog](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/changelog.md)
- [Get in Touch](https://perplexity-cf-proxied-beta.mintlify.site/docs/resources/discussions.md)
- [Perplexity Crawlers](https://perplexity-cf-proxied-beta.mintlify.site/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…
- [Perplexity API Cookbook](https://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/index.md): A collection of practical examples and guides for building with Perplexity's API Platform
- [Briefo | Perplexity Powered News & Finance Social App](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/showcase/valetudo-ai.md): Sonar-powered medical assistant for fast, science-backed answers.
- [CycleSyncAI | Personalized Health Plans Powered by Sonar API](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/showcase/flameguardai.md): AI-powered wildfire prevention using OpenAI Vision + Perplexity Sonar API
- [Monday – Voice-First AI Learning Assistant](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/examples/README.md): Ready-to-use applications demonstrating Perplexity Sonar API capabilities
- [Fact Checker CLI](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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
- [Chat Summary Memory Buffer](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/articles/openai-agents-integration/README.md): Complete guide for integrating Perplexity's Sonar API with the OpenAI Agents SDK
- [Memory Management](https://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/articles/memory-management/README.md): Advanced conversation memory solutions using LlamaIndex for persistent, context-aware applications
- [Persistent Chat Memory](https://perplexity-cf-proxied-beta.mintlify.site/docs/cookbook/articles/memory-management/chat-with-persistence/README.md): Long-term conversation memory using LanceDB vector storage and Perplexity Sonar API
- [Create Response](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/responses-post.md): Generate a response for the provided input with optional web search and reasoning.
- [Search the Web](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/search-post.md): Search the web and retrieve relevant web page contents.
- [Create Browser Session](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/browser-sessions-post.md): Create a new remote browser session for CDP-based automation.
- [Stop Browser Session](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/browser-sessions-delete.md): Stop and clean up a remote browser session.
- [Create Chat Completion](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/chat-completions-post.md): Generate a chat completion response for the given conversation.
- [Create Async Chat Completion](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/async-chat-completions-post.md): Submit an asynchronous chat completion request.
- [List Async Chat Completions](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/async-chat-completions-get.md): Retrieve a list of all asynchronous chat completion requests for a given user.
- [Get Async Chat Completion](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/async-chat-completions-api-request-get.md): Retrieve the response for a given asynchronous chat completion request.
- [Create Embeddings](https://perplexity-cf-proxied-beta.mintlify.site/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://perplexity-cf-proxied-beta.mintlify.site/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.
- [Generate Auth Token](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/generate-auth-token-post.md): Generates a new authentication token for API access.
- [Revoke Auth Token](https://perplexity-cf-proxied-beta.mintlify.site/api-reference/revoke-auth-token-post.md): Revokes an existing authentication token.

## OpenAPI Specs

- [openapi](https://perplexity-cf-proxied-beta.mintlify.site/openapi.json)
- [openapi-auth](https://perplexity-cf-proxied-beta.mintlify.site/openapi-auth.json)

## Optional

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