{"id":"src_jGOKM9WT6Uo_hf0ReuRxp","slug":"api-changelog","name":"API Changelog","type":"scrape","url":"https://docs.perplexity.ai/docs/resources/changelog","orgId":"org_Hw7rTErCOSh2ad-Ur_Jxt","productId":"prod_gBK1kHmqJ6QxElLBqNWD8","productSlug":"sonar","org":{"id":"org_Hw7rTErCOSh2ad-Ur_Jxt","slug":"perplexity","name":"Perplexity"},"isPrimary":true,"isHidden":false,"discovery":"curated","metadata":"{\"markdownUrl\":\"https://docs.perplexity.ai/docs/resources/changelog.md\",\"provider\":\"mintlify\",\"providerDetectedAt\":\"2026-05-26T11:36:32.184Z\",\"evaluatedMethod\":\"markdown\",\"evaluatedAt\":\"2026-05-26T11:36:32.184Z\"}","kind":null,"releaseCount":30,"releasesLast30Days":1,"avgReleasesPerWeek":0.2,"latestVersion":null,"latestDate":"2026-05-01T00:00:00.000Z","changelogUrl":null,"hasChangelogFile":false,"lastFetchedAt":"2026-05-26T11:43:02.481Z","lastPolledAt":"2026-05-26T12:01:01.866Z","trackingSince":"2024-04-01T00:00:00.000Z","releases":[{"id":"rel_by8rAFUAva6dMGo9OkFEi","version":null,"type":"feature","title":"Finance Search: Now Available","summary":"The `finance_search` tool is now available in the Agent API. Pull structured financial and market data — quotes, financials, earnings, analyst estimat...","titleGenerated":null,"titleShort":null,"content":"The `finance_search` tool is now available in the Agent API. Pull structured financial and market data — quotes, financials, earnings, analyst estimates, segment KPIs, ETF constituents, and more — for public companies and instruments. The model decides which fields to fetch based on your prompt.\n\n**Highlights:**\n- **Quotes and pricing**: Near-real-time prices, OHLCV ranges, pre-market and after-hours data\n- **Financials**: Income statement, balance sheet, cash flow (quarterly and annual), key ratios\n- **Earnings**: Last call transcript, filings, beat/miss history, guidance\n- **Coverage and market activity**: Analyst estimates, top gainers/losers, ownership and corporate actions\n- **Recommended configurations**: Presets for live quotes, single-company historical lookups, and multi-step cross-company research","publishedAt":"2026-05-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.014Z","url":"https://docs.perplexity.ai/docs/agent-api/tools/finance-search","media":[],"coverageCount":0},{"id":"rel_LDk0h74Nbbc91ic34IF0C","version":null,"type":"feature","title":"April 2026: Agent API New Models, API Key Security Upgrade, n8n & OpenClaw Integrations, AWS Marketplace, /v1/models Endpoint","summary":"**Agent API: New Third-Party Models** — Claude Opus 4.7, GPT-5.5, and Grok 4.20 Reasoning now supported.\n\n**API Key Management: Security Upgrade** — F...","titleGenerated":null,"titleShort":null,"content":"**Agent API: New Third-Party Models** — Claude Opus 4.7, GPT-5.5, and Grok 4.20 Reasoning now supported.\n\n**API Key Management: Security Upgrade** — Full token values now returned only at creation and cannot be retrieved again from the console or any endpoint. Always set a descriptive `token_name`.\n\n**New Integration: n8n** — Native Perplexity node with full API coverage (Chat Completions, Agent, Search, Embeddings). Models load dynamically.\n\n**New Integration: OpenClaw** — Open-source terminal AI agent now supports Perplexity Search API as a native web search provider.\n\n**API Credits via AWS Marketplace** — Purchase API credits through your AWS account for consolidated billing.\n\n**`/v1/models` Endpoint** — New `GET /v1/models` lists all available Agent API models in OpenAI-compatible format. No authentication required.","publishedAt":"2026-04-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.014Z","url":"https://docs.perplexity.ai/docs/resources/changelog#april-2026-agent-api-new-models-api-key-security-upgrade-n8n","media":[],"coverageCount":0},{"id":"rel_wPOjGEEJc0gmawDozcZtB","version":null,"type":"feature","title":"March 2026: Agent API New Models, Model Deprecations, /v1/agent Endpoint","summary":"**Agent API: New Third-Party Models** — GPT-5.4, NVIDIA Nemotron, Claude Sonnet 4.6, and Gemini 3.1 Pro Preview now supported.\n\n**Model Deprecations**...","titleGenerated":null,"titleShort":null,"content":"**Agent API: New Third-Party Models** — GPT-5.4, NVIDIA Nemotron, Claude Sonnet 4.6, and Gemini 3.1 Pro Preview now supported.\n\n**Model Deprecations** — `google/gemini-2.5-flash` deprecated March 20, 2026; `google/gemini-2.5-pro` and `google/gemini-3-pro-preview` deprecated April 1, 2026.\n\n**Agent API Endpoint `/v1/agent`** — Canonical endpoint is now `/v1/agent`. The previous `/v1/responses` path continues to work as an alias for OpenAI compatibility.","publishedAt":"2026-03-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.014Z","url":"https://docs.perplexity.ai/docs/resources/changelog#march-2026-agent-api-new-models-model-deprecations-v1-agent-","media":[],"coverageCount":0},{"id":"rel_sHuXGL0bwdpfLgZ6Wpoy_","version":null,"type":"feature","title":"Agent API: Now Generally Available","summary":"The **Agent API** is now generally available. Build autonomous agents with production-ready guidance on model behavior, output controls, and OpenAI-co...","titleGenerated":null,"titleShort":null,"content":"The **Agent API** is now generally available. Build autonomous agents with production-ready guidance on model behavior, output controls, and OpenAI-compatibility patterns.","publishedAt":"2026-02-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.014Z","url":"https://docs.perplexity.ai/docs/agent-api/quickstart","media":[],"coverageCount":0},{"id":"rel_3b16Yrwvn0oShZOsxKhxR","version":null,"type":"feature","title":"Embeddings API: Now Generally Available","summary":"The **Embeddings API** is now generally available with guides for standard and contextualized embeddings, plus best practices for semantic search and ...","titleGenerated":null,"titleShort":null,"content":"The **Embeddings API** is now generally available with guides for standard and contextualized embeddings, plus best practices for semantic search and retrieval workflows.","publishedAt":"2026-02-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.014Z","url":"https://docs.perplexity.ai/docs/embeddings/quickstart","media":[],"coverageCount":0},{"id":"rel_6XikLXBO-lsi_uqke1PJx","version":null,"type":"feature","title":"December 2025: Model Deprecation, Media Classifier, Search API Enhancements","summary":"**Model Deprecation: `sonar-reasoning` Removed** — As of December 15, 2025, `sonar-reasoning` has been deprecated. Migrate to `sonar-reasoning-pro`.\n\n...","titleGenerated":null,"titleShort":null,"content":"**Model Deprecation: `sonar-reasoning` Removed** — As of December 15, 2025, `sonar-reasoning` has been deprecated. Migrate to `sonar-reasoning-pro`.\n\n**New: Media Classifier** — Automatically detects when queries would benefit from visual content and includes relevant images or videos. Available exclusively with `sonar-pro`. Configurable control to enable/disable and override media types.\n\n**Search API Enhancements:**\n- New `max_tokens` parameter: Control maximum tokens extracted per page\n- `last_updated_filter` support: Filter results by when content was last updated\n- Vercel AI SDK Support: Search API now compatible with the Vercel AI SDK\n\n**Community Showcase:** Perplexity Client — Electron-based desktop application with advanced API parameter controls.","publishedAt":"2025-12-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.162Z","url":"https://docs.perplexity.ai/docs/resources/changelog#december-2025-model-deprecation-media-classifier-search-api-","media":[],"coverageCount":0},{"id":"rel_f73ykiwBgbahsAbaIxM86","version":null,"type":"feature","title":"MCP Server: One-Click Installation","summary":"The Perplexity MCP Server now supports one-click installation for Cursor, VS Code, Claude Desktop, and Claude Code. Provides four tools: `perplexity_s...","titleGenerated":null,"titleShort":null,"content":"The Perplexity MCP Server now supports one-click installation for Cursor, VS Code, Claude Desktop, and Claude Code. Provides four tools: `perplexity_search`, `perplexity_ask`, `perplexity_research`, and `perplexity_reason`.","publishedAt":"2025-11-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.162Z","url":"https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server","media":[],"coverageCount":0},{"id":"rel_4s0kICWdNsP9vFUsmNZp7","version":null,"type":"feature","title":"Pro Search: Now Generally Available","summary":"**Pro Search** is now generally available for Sonar Pro. Enhances queries with automated tool usage and multi-step reasoning through intelligent tool ...","titleGenerated":null,"titleShort":null,"content":"**Pro Search** is now generally available for Sonar Pro. Enhances queries with automated tool usage and multi-step reasoning through intelligent tool orchestration.\n\n**Key capabilities:**\n- Multi-step reasoning: Automatic multiple web searches and URL content fetching\n- Real-time thought streaming\n- Automatic classification via `search_type: \"auto\"`\n- Built-in tools: `web_search` and `fetch_url_content`","publishedAt":"2025-11-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.162Z","url":"https://docs.perplexity.ai/docs/sonar/pro-search/quickstart","media":[],"coverageCount":0},{"id":"rel_Jg8lg7ZQoAbyEel3KV8hT","version":null,"type":"feature","title":"New Search API Capabilities: language_preference, search_domain_filter, date/time filters","summary":"- **`language_preference`**: Specify preferred languages for search results (available for `sonar` and `sonar-pro`)\n- **`search_domain_filter`**: Filt...","titleGenerated":null,"titleShort":null,"content":"- **`language_preference`**: Specify preferred languages for search results (available for `sonar` and `sonar-pro`)\n- **`search_domain_filter`**: Filter results to specific domains\n- **Date/time filters**: Enhanced control over result freshness with publication and update filters","publishedAt":"2025-10-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.198Z","url":"https://docs.perplexity.ai/docs/resources/changelog#new-search-api-capabilities-language-preference-search-domai","media":[],"coverageCount":0},{"id":"rel_SHKB2RIoYbUgkepb68e9u","version":null,"type":"feature","title":"Official Perplexity SDKs for Python and TypeScript","summary":"Official **Perplexity SDKs** for Python and TypeScript are now available.\n\n**Installation:**\n```\n# Python\npip install perplexityai\n\n# TypeScript\nnpm i...","titleGenerated":null,"titleShort":null,"content":"Official **Perplexity SDKs** for Python and TypeScript are now available.\n\n**Installation:**\n```\n# Python\npip install perplexityai\n\n# TypeScript\nnpm install @perplexity-ai/perplexity_ai\n```\n\n**Features:**\n- Full type definitions for all request/response fields\n- Support for Sonar and Search APIs\n- Streaming support with async iterators\n- Automatic environment variable handling for API keys","publishedAt":"2025-10-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.162Z","url":"https://docs.perplexity.ai/docs/sdk/overview","media":[],"coverageCount":0},{"id":"rel_BUTaHTfm6-bdtcinRkRtR","version":null,"type":"feature","title":"Interactive Search API Playground","summary":"New interactive playground to test Search API queries and parameters in real time — no API key required to get started. Experiment with filtering opti...","titleGenerated":null,"titleShort":null,"content":"New interactive playground to test Search API queries and parameters in real time — no API key required to get started. Experiment with filtering options, see response structures, and refine queries before implementing in code.","publishedAt":"2025-10-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.162Z","url":"https://console.perplexity.ai/","media":[],"coverageCount":0},{"id":"rel_XglurzlxYUVNbtjaNZylh","version":null,"type":"feature","title":"New: Search-only API","summary":"Standalone Search API providing direct access to search results without LLM processing. Returns raw, ranked search results from Perplexity's continuou...","titleGenerated":null,"titleShort":null,"content":"Standalone Search API providing direct access to search results without LLM processing. Returns raw, ranked search results from Perplexity's continuously refreshed index.\n\n**Perfect for:** building custom search experiences, integrating raw search results into applications, specialized workflows.\n\n**Key features:**\n- Direct access to Perplexity's search index\n- All existing search filters and controls\n- Faster responses (no LLM processing)\n- Same filtering options (domain, date range, academic sources, etc.)","publishedAt":"2025-09-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.198Z","url":"https://docs.perplexity.ai/docs/search/quickstart","media":[],"coverageCount":0},{"id":"rel_NYhh6-Udpy0xy0o94Rwt1","version":null,"type":"feature","title":"New: File Attachments Support","summary":"Upload and analyze documents in multiple formats using Sonar models. Supports PDF, DOC, DOCX, TXT, and RTF files.\n\n**Key capabilities:**\n- Document An...","titleGenerated":null,"titleShort":null,"content":"Upload and analyze documents in multiple formats using Sonar models. Supports PDF, DOC, DOCX, TXT, and RTF files.\n\n**Key capabilities:**\n- Document Analysis: Ask questions about document content\n- Content Extraction: Pull out key information and insights\n- Multi-format Support: PDF, Word, text, and Rich Text Format\n- Large Document Handling and Multi-language Support\n\nUpload via publicly accessible URLs using the `file_url` content type.","publishedAt":"2025-09-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.198Z","url":"https://docs.perplexity.ai/docs/sonar/media#sending-files","media":[],"coverageCount":0},{"id":"rel_imwbSwWk5e0rKXb81_CMD","version":null,"type":"feature","title":"API Model Deprecation: R1-1776 Removed","summary":"As of August 1, 2025, R1-1776 has been removed from the available models. Recommended replacement: `Sonar Pro Reasoning`.","titleGenerated":null,"titleShort":null,"content":"As of August 1, 2025, R1-1776 has been removed from the available models. Recommended replacement: `Sonar Pro Reasoning`.","publishedAt":"2025-08-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.198Z","url":"https://docs.perplexity.ai/docs/resources/changelog#api-model-deprecation-r1-1776-removed","media":[],"coverageCount":0},{"id":"rel_q0POu5LJTlytTH_Jsk8TF","version":null,"type":"feature","title":"New: SEC Filings Filter for Financial Research","summary":"New SEC filings filter allows searching specifically within SEC regulatory documents. Set `search_domain: \"sec\"` to focus on 10-K, 10-Q, 8-K, and othe...","titleGenerated":null,"titleShort":null,"content":"New SEC filings filter allows searching specifically within SEC regulatory documents. Set `search_domain: \"sec\"` to focus on 10-K, 10-Q, 8-K, and other regulatory filings.\n\nWorks with other search parameters like date filters and search context size. Useful for financial analysts, investment professionals, and compliance officers.","publishedAt":"2025-07-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.263Z","url":"https://docs.perplexity.ai/guides/sec-guide","media":[],"coverageCount":0},{"id":"rel_Bll4g9gKgH6acWZ5RIfUW","version":null,"type":"feature","title":"New: Detailed Cost Information in API Responses","summary":"API response JSON now includes detailed cost information for each request via a new `cost` object in the `usage` field.\n\n```json\n\"usage\": {\n  \"prompt_...","titleGenerated":null,"titleShort":null,"content":"API response JSON now includes detailed cost information for each request via a new `cost` object in the `usage` field.\n\n```json\n\"usage\": {\n  \"prompt_tokens\": 8,\n  \"completion_tokens\": 439,\n  \"total_tokens\": 447,\n  \"search_context_size\": \"low\",\n  \"cost\": {\n    \"input_tokens_cost\": 2.4e-05,\n    \"output_tokens_cost\": 0.006585,\n    \"request_cost\": 0.006,\n    \"total_cost\": 0.012609\n  }\n}\n```\n\nIncludes: `input_tokens_cost`, `output_tokens_cost`, `request_cost`, `total_cost`.","publishedAt":"2025-07-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.263Z","url":"https://docs.perplexity.ai/docs/resources/changelog#new-detailed-cost-information-in-api-responses","media":[],"coverageCount":0},{"id":"rel_1Kt-46IBM2G775tpmo3Vn","version":null,"type":"feature","title":"New: Academic Filter for Scholarly Research","summary":"New academic filter allows tailoring searches to academic and scholarly sources. Set `search_mode: \"academic\"` to prioritize results from peer-reviewe...","titleGenerated":null,"titleShort":null,"content":"New academic filter allows tailoring searches to academic and scholarly sources. Set `search_mode: \"academic\"` to prioritize results from peer-reviewed papers, journal articles, and research publications.\n\nWorks with `search_context_size` and date filters. Ideal for students, researchers, and professionals requiring scientifically accurate information.","publishedAt":"2025-06-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.263Z","url":"https://docs.perplexity.ai/guides/academic-filter-guide","media":[],"coverageCount":0},{"id":"rel_1I-NzWV9bxJjYtCq0X3EB","version":null,"type":"feature","title":"Enhanced: Date Range Filtering with latest_updated Field","summary":"New `latest_updated` field added to date range filtering, allowing filtering based on when a webpage was last modified.\n\n**New fields:**\n- `latest_upd...","titleGenerated":null,"titleShort":null,"content":"New `latest_updated` field added to date range filtering, allowing filtering based on when a webpage was last modified.\n\n**New fields:**\n- `latest_updated`: Filter by last modification date\n- `published_after` / `published_before`: Existing publication date filters\n\nUseful for finding the most current version of frequently updated content.","publishedAt":"2025-06-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.263Z","url":"https://docs.perplexity.ai/guides/date-range-filter-guide","media":[],"coverageCount":0},{"id":"rel_8ztLGZQQ9Zr4relUGo8wE","version":null,"type":"feature","title":"Enhanced API Responses with search_results Field; citations Deprecated","summary":"New `search_results` field added to API response JSON, providing direct access to search results used by models.\n\n**Fields included:**\n- `title`: Titl...","titleGenerated":null,"titleShort":null,"content":"New `search_results` field added to API response JSON, providing direct access to search results used by models.\n\n**Fields included:**\n- `title`: Title of the search result page\n- `url`: URL of the search result\n- `date`: Publication date of the content\n\n**Breaking Change:** The `citations` field has been fully deprecated and removed. All applications must now use the `search_results` field.","publishedAt":"2025-05-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.303Z","url":"https://docs.perplexity.ai/docs/resources/changelog#enhanced-api-responses-with-search-results-field-citations-d","media":[],"coverageCount":0},{"id":"rel_IT_WPmt9aMNBxrv8TUT9s","version":null,"type":"feature","title":"New: Reasoning Effort Parameter for Sonar Deep Research","summary":"New `reasoning_effort` parameter for `sonar-deep-research` to control computational effort per query.\n\n**Options:**\n- `\"low\"`: Faster, simpler answers...","titleGenerated":null,"titleShort":null,"content":"New `reasoning_effort` parameter for `sonar-deep-research` to control computational effort per query.\n\n**Options:**\n- `\"low\"`: Faster, simpler answers with reduced token usage\n- `\"medium\"`: Balanced approach (default)\n- `\"high\"`: Deeper, more thorough responses with increased token usage\n\nDirectly impacts reasoning tokens consumed, enabling cost control.","publishedAt":"2025-05-01T00:00:00.000Z","fetchedAt":"2026-05-26T11:43:02.263Z","url":"https://docs.perplexity.ai/docs/sonar/models/sonar-deep-research","media":[],"coverageCount":0}],"pagination":{"nextCursor":"2025-05-01T00:00:00.000Z|2026-05-26T11:43:02.263Z|rel_IT_WPmt9aMNBxrv8TUT9s","limit":20},"summaries":{"rolling":null,"monthly":[]}}