{
  "name": "Perplexity Sonar API",
  "slug": "perplexity-sonar",
  "website_url": "https://docs.perplexity.ai",
  "vendor_description": "\"Power your products with unparalleled real-time, web-wide research and Q&A capabilities.\"",
  "categories": [
    "web-search"
  ],
  "summary": "Perplexity Sonar API is a REST-based search and language model service that lets developers add real-time web retrieval, Q&A with inline citations, deep research, and semantic embeddings to their products. Pricing is usage-based starting at $1.00 per million tokens, with self-serve signup and no sales call required. The API ships SDKs for Python, TypeScript, and Node.js MCP, holds SOC 2 Type 2 certification, enforces a zero data-retention policy, and counts Samsung among its documented customers.",
  "capabilities": {
    "supported_actions": [
      "chat_completions_with_web_search (POST /v1/chat/completions)",
      "async_chat_completions (POST /v1/async/sonar)",
      "get_async_response (GET /v1/async/sonar/{api_request})",
      "list_async_requests (GET /v1/async/sonar)",
      "web_search (POST /v1/search)",
      "embeddings (POST /v1/embeddings)",
      "contextualized_embeddings (POST /v1/embeddings/contextualized)",
      "agent_completions (POST /v1/agent)",
      "list_models (GET /v1/models)"
    ],
    "supported_regions": [
      "Global web index; compute hosted on AWS in North America"
    ],
    "supported_languages": [
      "Queries accepted in multiple languages via ISO 639-1 search_language_filter parameter (up to 10 languages per request); English is primary"
    ],
    "input_types": [
      "natural language query",
      "structured chat messages (OpenAI-compatible)",
      "domain filter arrays",
      "date/recency filters",
      "ISO 639-1 language filter",
      "ISO 3166 country/location filter",
      "base64-encoded images",
      "HTTPS image URLs"
    ],
    "output_types": [
      "JSON (OpenAI-compatible chat completion)",
      "streaming server-sent events",
      "citations array with source URLs",
      "search_results metadata",
      "token usage metrics",
      "structured JSON schema output",
      "vector embeddings"
    ],
    "webhooks_supported": false,
    "sandbox_available": false,
    "sdk_languages": [
      "Python",
      "TypeScript",
      "MCP (Node.js)"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.perplexity.ai",
    "api_version": "v1",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": "https://docs.perplexity.ai/changelog/changelog",
    "auth_methods": [
      "api_key"
    ],
    "auth_docs_url": "https://docs.perplexity.ai/docs/getting-started/quickstart",
    "idempotency_supported": false,
    "error_format": "vendor-specific",
    "webhook_signing": null,
    "webhook_events_url": null,
    "rate_limit_requests": 50,
    "rate_limit_window": "minute",
    "sdk_packages": [
      {
        "package": "perplexityai",
        "language": "Python",
        "official": true,
        "repo_url": "https://github.com/perplexityai/perplexity-py"
      },
      {
        "package": "@perplexity-ai/perplexity_ai",
        "language": "TypeScript",
        "official": true,
        "repo_url": "https://github.com/perplexityai/perplexity-node"
      },
      {
        "package": "@perplexity-ai/mcp-server",
        "language": "MCP (Node.js)",
        "official": true,
        "repo_url": "https://github.com/perplexityai/modelcontextprotocol"
      }
    ],
    "mcp_url": "https://docs.perplexity.ai/guides/mcp-server",
    "quickstart_url": "https://docs.perplexity.ai/docs/getting-started/quickstart"
  },
  "pricing": {
    "pricing_model": "usage_based",
    "has_published_pricing": true,
    "starting_price_usd": "1.0000",
    "price_basis": "1M tokens",
    "free_tier_available": false,
    "free_tier_limit": null,
    "free_tier_details": null,
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Sonar",
        "item": "input tokens",
        "amount_usd": "1.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar",
        "item": "output tokens",
        "amount_usd": "1.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar",
        "item": "request fee (low search context)",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar",
        "item": "request fee (medium search context)",
        "amount_usd": "8.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar",
        "item": "request fee (high search context)",
        "amount_usd": "12.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "input tokens",
        "amount_usd": "3.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "output tokens",
        "amount_usd": "15.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "request fee (low search context)",
        "amount_usd": "6.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "request fee (medium search context)",
        "amount_usd": "10.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "request fee (high search context)",
        "amount_usd": "14.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (fast/standard, low context)",
        "amount_usd": "6.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (fast/standard, medium context)",
        "amount_usd": "10.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (fast/standard, high context)",
        "amount_usd": "14.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (pro/multi-step, low context)",
        "amount_usd": "14.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (pro/multi-step, medium context)",
        "amount_usd": "18.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Pro",
        "item": "Pro Search request fee (pro/multi-step, high context)",
        "amount_usd": "22.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Reasoning Pro",
        "item": "input tokens",
        "amount_usd": "2.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Reasoning Pro",
        "item": "output tokens",
        "amount_usd": "8.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Reasoning Pro",
        "item": "request fee (low search context)",
        "amount_usd": "6.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Reasoning Pro",
        "item": "request fee (medium search context)",
        "amount_usd": "10.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Reasoning Pro",
        "item": "request fee (high search context)",
        "amount_usd": "14.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Deep Research",
        "item": "input tokens",
        "amount_usd": "2.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Deep Research",
        "item": "output tokens",
        "amount_usd": "8.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Deep Research",
        "item": "citation tokens",
        "amount_usd": "2.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Deep Research",
        "item": "reasoning tokens",
        "amount_usd": "3.0000",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Sonar Deep Research",
        "item": "search queries",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "1,000 queries",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Search API",
        "item": "web search requests",
        "amount_usd": "5.0000",
        "amount_percent": null,
        "per": "1,000 requests",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Embeddings API",
        "item": "pplx-embed-v1-0.6b tokens",
        "amount_usd": "0.0040",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Embeddings API",
        "item": "pplx-embed-v1-4b tokens",
        "amount_usd": "0.0300",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Embeddings API",
        "item": "pplx-embed-context-v1-0.6b (contextualized) tokens",
        "amount_usd": "0.0080",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Embeddings API",
        "item": "pplx-embed-context-v1-4b (contextualized) tokens",
        "amount_usd": "0.0500",
        "amount_percent": null,
        "per": "1M tokens",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Agent API",
        "item": "web_search tool call",
        "amount_usd": "0.0050",
        "amount_percent": null,
        "per": "call",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Agent API",
        "item": "fetch_url tool call",
        "amount_usd": "0.0005",
        "amount_percent": null,
        "per": "call",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Agent API",
        "item": "people_search tool call",
        "amount_usd": "0.0050",
        "amount_percent": null,
        "per": "call",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Agent API",
        "item": "finance_search tool call",
        "amount_usd": "0.0050",
        "amount_percent": null,
        "per": "call",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      },
      {
        "plan": "Agent API",
        "item": "sandbox session (20-minute window)",
        "amount_usd": "0.0300",
        "amount_percent": null,
        "per": "session",
        "currency": "USD",
        "source_url": "https://docs.perplexity.ai/docs/getting-started/pricing"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": false,
    "gdpr": null,
    "iso_27001": null,
    "pci_dss": null,
    "sla_published": false,
    "sla_url": null,
    "data_retention_policy_url": "https://docs.perplexity.ai/docs/resources/privacy-security",
    "documented_rate_limits": "Tier-based RPM by model. Sonar / Sonar Pro / Sonar Reasoning Pro: Tier 0=50 RPM, Tier 1=150, Tier 2=500, Tier 3=1,000, Tier 4=4,000, Tier 5=4,000. Sonar Deep Research: Tier 0=5, Tier 1=10, Tier 2=20, Tier 3=40, Tier 4=60, Tier 5=100 RPM. Search API: 50 req/s fixed across all tiers. Tiers advance by cumulative lifetime spend: Tier 1=$50+, Tier 2=$250+, Tier 3=$500+, Tier 4=$1,000+, Tier 5=$5,000+.",
    "known_restrictions": [
      "Zero data retention policy: no customer prompt/response data is retained after request processing",
      "Customer data is never used for model training",
      "Protected Health Information cannot be processed without a signed Business Associate Agreement",
      "Fine-tuning of models is not supported",
      "No uptime SLA or service quality guarantees published ('We do not guarantee this at the moment')",
      "SafeSearch content filtering is on by default",
      "Domain and date filters cannot be combined in certain ways; max 20 domains per filter",
      "Perplexity may suspend access for applications deemed competitive with Perplexity",
      "Search API Terms of Service explicitly states no enhanced security obligations or uptime guarantees apply to Search Services"
    ]
  },
  "developer": {
    "docs_url": "https://docs.perplexity.ai/docs",
    "api_reference_url": "https://docs.perplexity.ai/api-reference/agent-post",
    "openapi_spec_url": "https://docs.perplexity.ai/openapi.json",
    "postman_collection_url": null,
    "changelog_url": "https://docs.perplexity.ai/changelog",
    "status_page_url": null,
    "llms_txt_url": "https://docs.perplexity.ai/llms.txt",
    "markdown_docs_url": "https://docs.perplexity.ai/docs.md",
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2023-10-04",
    "ga_date": "2025-01-01",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "Samsung"
    ]
  },
  "scores": {
    "agent_friendliness": 90,
    "pricing_transparency": 85,
    "setup_speed": 60,
    "docs_quality": 90,
    "procurement_friction": 85,
    "trust_readiness": 25,
    "best_for": [
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)",
      "Teams needing broad API coverage out of the box"
    ],
    "avoid_if": [
      "You want to try it free before paying"
    ]
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://docs.perplexity.ai/docs/getting-started",
      "excerpt": "Power your products with unparalleled real-time, web-wide research and Q&A capabilities.",
      "confidence": "high"
    },
    {
      "field": "pricing_model / has_published_pricing",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "Sonar: $1 input / $1 output per 1M tokens. Request Fees: Sonar $5 (low) / $8 (medium) / $12 (high) per 1,000 requests. Search API: $5.00 per 1,000 requests (no token costs).",
      "confidence": "high"
    },
    {
      "field": "pricing_model / has_published_pricing",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "Sonar Pro: $3 input / $15 output per 1M tokens. Sonar Reasoning Pro: $2 input / $8 output. Sonar Deep Research: $2 input / $8 output, plus $2 citation tokens, $3 reasoning tokens, $5 per 1K search queries.",
      "confidence": "high"
    },
    {
      "field": "supported_actions (async endpoint path)",
      "url": "https://docs.perplexity.ai/api-reference/async-sonar-post",
      "excerpt": "POST /v1/async/sonar — asynchronous chat completion request to execute asynchronously",
      "confidence": "high"
    },
    {
      "field": "supported_actions (async endpoint path)",
      "url": "https://docs.perplexity.ai/llms.txt",
      "excerpt": "POST /v1/agent - Generate responses with optional web search and reasoning. POST /v1/chat/completions - Generate chat completions with web grounding. POST /v1/search - Access real-time web search with ranking and filtering. POST /v1/embeddings - Standard text embeddings for semantic search.",
      "confidence": "high"
    },
    {
      "field": "sdk_languages",
      "url": "https://docs.perplexity.ai/docs/getting-started/quickstart",
      "excerpt": "Native SDKs: Python (pip install perplexityai) and TypeScript (npm install @perplexity-ai/perplexity_ai). OpenAI-Compatible Libraries: Python (pip install openai) and TypeScript (npm install openai) with custom base URL.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://github.com/perplexityai/modelcontextprotocol",
      "excerpt": "This is the official MCP server implementation published by Perplexity AI, available as an open-source project on GitHub under the MIT license.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://docs.perplexity.ai/docs/getting-started/integrations/mcp-server",
      "excerpt": "NPM Package: @perplexity-ai/mcp-server",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.perplexity.ai/guides/usage-tiers",
      "excerpt": "Tier 0: sonar-deep-research (5 RPM), sonar-reasoning-pro/pro/standard (50 RPM each). Tier 4: sonar-deep-research (60 RPM), reasoning-pro/pro/standard (4,000 RPM each). Search API fixed: 50 requests per second across all tiers.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://docs.perplexity.ai/guides/usage-tiers",
      "excerpt": "Tiers are based on cumulative purchases across your account lifetime, not current balance. Tier 1: $50+, Tier 2: $250+, Tier 3: $500+, Tier 4: $1,000+, Tier 5: $5,000+",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://docs.perplexity.ai/docs/resources/privacy-security",
      "excerpt": "SOC 2 Type II Report - Comprehensive security controls audit covering security, availability, processing integrity, confidentiality, and privacy",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://docs.perplexity.ai/docs/resources/privacy-security",
      "excerpt": "2025 HIPAA Gap Assessment - Healthcare data protection compliance evaluation",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://hub-prod.perplexity.ai/hub/legal/perplexity-api-terms-of-service",
      "excerpt": "Protected health information cannot be processed unless a Business Associate Agreement is executed with Perplexity.",
      "confidence": "high"
    },
    {
      "field": "gdpr / iso_27001 / pci_dss",
      "url": "https://docs.perplexity.ai/docs/resources/privacy-security",
      "excerpt": "Certifications listed: SOC 2 Type II Report, 2025 HIPAA Gap Assessment, CAIQlite. GDPR, ISO 27001, and PCI DSS are not mentioned on this page.",
      "confidence": "low"
    },
    {
      "field": "gdpr / iso_27001 / pci_dss",
      "url": "https://trust.perplexity.ai/",
      "excerpt": null,
      "confidence": "low"
    },
    {
      "field": "sla_published",
      "url": "https://docs.perplexity.ai/docs/resources/faq",
      "excerpt": "We do not guarantee this at the moment regarding uptime assurances and failure metrics.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.perplexity.ai/hub/legal/perplexity-api-terms-of-service-search",
      "excerpt": "no enhanced security obligations, service levels, uptime guarantees or other performance commitments offered in respect of Perplexity's other products and services apply to the Search Services",
      "confidence": "high"
    },
    {
      "field": "known_restrictions (zero data retention)",
      "url": "https://docs.perplexity.ai/docs/resources/privacy-security",
      "excerpt": "We do not retain any data sent via the Sonar API, and we absolutely do not use any customer data to train our models or for any other purposes beyond processing your immediate request.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions (SafeSearch, fine-tuning)",
      "url": "https://docs.perplexity.ai/docs/resources/faq",
      "excerpt": "SafeSearch is turned on by default to filter inappropriate content. Currently, we do not support fine-tuning.",
      "confidence": "high"
    },
    {
      "field": "supported_regions",
      "url": "https://docs.perplexity.ai/docs/resources/faq",
      "excerpt": "Our compute is hosted via Amazon Web Services in North America.",
      "confidence": "high"
    },
    {
      "field": "free_tier_available / sandbox_available",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "No free tier or trial credits are mentioned in this documentation.",
      "confidence": "high"
    },
    {
      "field": "free_tier_available / sandbox_available",
      "url": "https://hub-prod.perplexity.ai/hub/legal/perplexity-api-terms-of-service",
      "excerpt": "During the term of such free trial Perplexity may terminate or suspend this Agreement and/or Customer's access to the Services at any time for any reason. Standard pricing automatically applies after trial conclusion.",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://www.perplexity.ai/enterprise/pricing",
      "excerpt": "Perplexity Enterprise Pricing - Get Started Today (enterprise inquiry form for custom pricing, dedicated support)",
      "confidence": "high"
    },
    {
      "field": "embeddings pricing (new price points found)",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "pplx-embed-v1-0.6b: $0.004/1M tokens; pplx-embed-v1-4b: $0.03/1M tokens; contextualized variants: $0.008/1M and $0.05/1M tokens respectively",
      "confidence": "high"
    },
    {
      "field": "Agent API tool pricing (new price points found)",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "Agent API tools: web_search $0.005/call, fetch_url $0.0005/call, people_search $0.005/call, finance_search $0.005/call, sandbox $0.03/session. Tool costs are separate from model token costs.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://docs.perplexity.ai/docs/sonar/openai-compatibility.md",
      "excerpt": "client = OpenAI(api_key=os.environ.get(\"PERPLEXITY_API_KEY\"), base_url=\"https://api.perplexity.ai\")",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://docs.perplexity.ai/api-reference/sonar-post.md",
      "excerpt": "Endpoint Path: /v1/sonar ... API Version: 1.0.0",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://docs.perplexity.ai/docs/getting-started/quickstart",
      "excerpt": "Authorization: Bearer $PERPLEXITY_API_KEY",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://docs.perplexity.ai/api-reference/sonar-post.md",
      "excerpt": "HTTP Method: POST ... Content-Type: application/json",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://docs.perplexity.ai/changelog/changelog",
      "excerpt": "January 2025: Launch of Sonar and Sonar Pro APIs, described as 'the most efficient and cost-effective search solutions available.' Both offer 'built-in citations, automated scaling of rate limits, and public access to advanced features.'",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/perplexityai/perplexity-py",
      "excerpt": "The project provides convenient access to the Perplexity REST API from Python applications. Latest release: v0.38.0 (June 8, 2026)",
      "confidence": "high"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/perplexityai/perplexity-node",
      "excerpt": "This library provides convenient access to the Perplexity REST API from server-side TypeScript or JavaScript. npm package: @perplexity-ai/perplexity_ai",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://github.com/perplexityai/modelcontextprotocol",
      "excerpt": "npm Package Name: @perplexity-ai/mcp-server ... claude mcp add perplexity --env PERPLEXITY_API_KEY=\"your_key_here\" -- npx -y @perplexity-ai/mcp-server",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://docs.perplexity.ai/guides/mcp-server",
      "excerpt": "NPM Package: @perplexity-ai/mcp-server",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://docs.perplexity.ai/docs/admin/rate-limits-usage-tiers",
      "excerpt": "Tier 0: sonar-reasoning-pro/pro/base (50 RPM) ... Tier 1: sonar-reasoning-pro/pro/base (150 RPM)",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://docs.perplexity.ai/docs/admin/rate-limits-usage-tiers",
      "excerpt": "The system uses a leaky bucket algorithm that allows for burst traffic while maintaining strict long-term rate control. Tokens refill continuously at regular intervals based on your rate limit.",
      "confidence": "high"
    },
    {
      "field": "starting_price_usd",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "Sonar API Token pricing (per 1M tokens): Sonar: $1 input / $1 output",
      "confidence": "high"
    },
    {
      "field": "price_basis",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "Token pricing (per 1M tokens): Sonar: $1 input / $1 output. Sonar Pro: $3 input / $15 output. Sonar Reasoning Pro: $2 input / $8 output. Sonar Deep Research: $2 input / $8 output",
      "confidence": "high"
    },
    {
      "field": "free_tier_limit",
      "url": "https://docs.perplexity.ai/docs/getting-started/pricing",
      "excerpt": "The page contains no mention of a free tier, trial credits, or complimentary account offerings for new users.",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://www.perplexity.ai/hub/blog/introducing-pplx-api",
      "excerpt": "Introducing pplx-api blog post was published on October 4, 2023 introducing their pplx-api service, which provides developers with access to state-of-the-art open-source models through a REST API",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://docs.perplexity.ai/changelog/changelog",
      "excerpt": "January 2025: Launch of Sonar and Sonar Pro APIs, described as 'the most efficient and cost-effective search solutions available.' Both offer 'built-in citations, automated scaling of rate limits, and public access to advanced features.'",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://techcrunch.com/2025/01/21/perplexity-launches-sonar-an-api-for-ai-search",
      "excerpt": "perplexity launches sonar an api for ai search [January 21, 2025]",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.androidheadlines.com/2026/02/galaxy-s26-perplexity-ai-system-level-integration.html",
      "excerpt": "Samsung Galaxy S26's Perplexity AI Integration is Deeper Than You Think ... Perplexity's Sonar API now powering the core intelligence of the device",
      "confidence": "medium"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://docs.perplexity.ai/docs/resources/privacy-security",
      "excerpt": "We do not retain any data sent via the Sonar API, and we absolutely do not use any customer data to train our models or for any other purposes beyond processing your immediate request.",
      "confidence": "high"
    },
    {
      "field": "sla_url",
      "url": "https://www.perplexity.ai/hub/legal/perplexity-api-terms-of-service-search",
      "excerpt": "No enhanced security obligations, service levels, uptime guarantees or other performance commitments apply to the Search Services.",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://docs.perplexity.ai/changelog/changelog",
      "excerpt": "As of August 1, 2025, R1-1776 will be removed from the available models... As of December 15, 2025, the sonar-reasoning model has been deprecated and removed from the API.",
      "confidence": "medium"
    },
    {
      "field": "error_format",
      "url": "https://docs.perplexity.ai/api-reference/sonar-post.md",
      "excerpt": "Error (422): HTTPValidationError with validation details",
      "confidence": "medium"
    },
    {
      "field": "versioning_scheme",
      "url": "https://docs.perplexity.ai/api-reference/sonar-post.md",
      "excerpt": "Endpoint Path: /v1/sonar ... HTTP Method: POST",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://docs.perplexity.ai/docs/admin/api-key-management",
      "excerpt": "Users must first establish an API group through the Perplexity web console before generating any keys. The documentation doesn't explicitly detail verification requirements beyond account access to the console.",
      "confidence": "medium"
    }
  ],
  "fields_not_found": [
    "iso_27001",
    "gdpr",
    "pci_dss",
    "free_tier_details",
    "minimum_commitment",
    "context_window sizes for Sonar models (not published on model cards page)",
    "sla_url",
    "free_tier_limit",
    "webhook_signing",
    "webhook_events_url",
    "idempotency_supported"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-14T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/perplexity-sonar",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/perplexity-sonar/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme API",
            "website_url": "https://acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example"
            }
          ]
        }
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}