
Perplexity Sonar API
perplexity.ai
Search-grounded answers and a raw web search API.
What it does
Sonar models with web-grounded answers, an Agent API with priced tools and a raw Search API; usage tiers by cumulative spend.
In its API docs
Pricing
What Perplexity Sonar publishes for buying direct, as listed on its own pages.
Buying direct from Perplexity Sonar
- Search API$5.00 per 1K requests
- web_search tool$0.0025 per invocation
Docs
Perplexity Sonar's own pages, linked as published.
- API referencedocs.perplexity.ai/api-reference/agent-post
- OpenAPI specdocs.perplexity.ai/openapi.json
- Pricingdocs.perplexity.ai/getting-started/pricing
- Rate limitsdocs.perplexity.ai/docs/admin/rate-limits-usage-tiers
- Status pagestatus.perplexity.com
- Websiteperplexity.ai
Its OpenAPI document: 22 operations and rate limits
| Method | Path | Summary | Params | Source |
|---|---|---|---|---|
| POST | /v1/sonar | Create Chat Completion | 0 | Spec |
| POST | /search | Search the Web | 0 | Spec |
| POST | /v1/embeddings | Create Embeddings | 0 | Spec |
| POST | /v1/contextualizedembeddings | Create Contextualized Embeddings | 0 | Spec |
| GET | /v1/async/sonar/{api_request} | Get Async Chat Completion | 1 | Spec |
| GET | /v1/async/sonar | List Async Chat Completions | 0 | Spec |
| POST | /v1/async/sonar | Create Async Chat Completion | 0 | Spec |
| POST | /v1/agent | Create Agent Response | 0 | Spec |
| GET | /v1/agent/{id} | Retrieve Agent Response | 1 | Spec |
| GET | /v1/agent/{id}/files | List Agent Response Files | 1 | Spec |
| GET | /v1/agent/{id}/files/{file_id}/content | Download Agent Response File | 2 | Spec |
| POST | /v1/agent/{id}/cancel | Cancel Agent Response | 1 | Spec |
| GET | /v1/models | List Models | 0 | Spec |
| GET | /v1/analytics/computer/usage | Usage Analytics | 7 | Spec |
| GET | /v2/analytics/computer/usage | Usage Analytics per Member | 6 | Spec |
| GET | /v1/skills | List skills | 0 | Spec |
| POST | /v1/skills | Create a skill | 0 | Spec |
| GET | /v1/skills/{skill_id} | Get a skill | 0 | Spec |
| PUT | /v1/skills/{skill_id} | Add a skill revision | 0 | Spec |
| DELETE | /v1/skills/{skill_id} | Delete a skill | 0 | Spec |
| GET | /v1/skills/{skill_id}/revisions | List skill revisions | 0 | Spec |
| GET | /v1/skills/{skill_id}/download | Get a skill download URL | 0 | Spec |
Rate limits
| Limit | Scope | Plan | Endpoint | Burst / concurrency |
|---|---|---|---|---|
| 1 / second | plan | Tier 0 | Agent API | — / — |
| 3 / second | plan | Tier 1 ($50+) | Agent API | — / — |
| 8 / second | plan | Tier 2 ($250+) | Agent API | — / — |
| 17 / second | plan | Tier 3 ($500+) | Agent API | — / — |
| 33 / second | plan | Tier 4 ($1,000+) | Agent API | — / — |
| 33 / second | plan | Tier 5 ($5,000+) | Agent API | — / — |
Headers: Retry-After. On 429: Rate limited or upstream overloaded; 429s are not billed. GridRouter never paces above these and backs off on 429, honoring Retry-After. Source, checked Sep 29, 2026
Sources for this page (2)
- Perplexity API pricingchecked Sep 29, 2026
- Perplexity rate limitschecked Sep 29, 2026