using-perplexity-platformlisted

# Perplexity Sonar API Development Skill ## Quick Reference Perplexity Sonar API development with Python and TypeScript/JavaScript clients. Covers Sonar model family for search-augmented generation, Chat Completions API (OpenAI-compatible), real-time web search, citations, and streaming. --- ## Table of Contents 1. [When to Use](#when-to-use) 2. [Sonar Model Family](#sonar-model-family) 3. [Quick Start](#quick-start) 4. [Chat Completions API](#chat-completions-api) 5. [Citations and Sources](#citations-and-sources) 6. [Search Configuration](#search-configuration) 7. [Streaming](#streaming) 8. [Error Handling](#error-handling) 9. [Best Practices](#best-practices) 10. [Anti-Patterns](#anti-patterns) 11. [Integration Checklist](#integration-checklist) 12. [When to Use Perplexity vs Others](#when-to-use-perplexity-vs-others) 13. [CLI Quick Test](#cli-quick-test) 14. [See Also](#see-also) --- ## When to Use This skill is loaded by `backend-developer` when: - `openai` package in `requirements.txt` or `pyproject.toml` with Perplexity base URL - Environment variables `PERPLEXITY_API_KEY` or `PPLX_API_KEY` present - User mentions "Perplexity", "Sonar", or "search-augmented" in task - Code uses `api.perplexity.ai` base URL **Minimum Detection Confidence**: 0.8 (80%) --- ## Sonar Model Family ### Available Models | Model | Context | Search | Use Case | Speed | |-------|---------|--------|----------|-------| | `sonar` | 128K | Yes | General search-augmented | Fast | | `sonar