🔭│api-announcements

[last tartan]

We're excited to share a new update for the Sonar API:

The API response JSON now includes detailed cost information for each request!

You'll now see a new structure like this in your response:

"usage": {
    "prompt_tokens": 8,
    "completion_tokens": 439,
    "total_tokens": 447,
    "search_context_size": "low",
    "cost": {
     "input_tokens_cost": 2.4e-05,
     "output_tokens_cost": 0.006585,
     "request_cost": 0.006,
     "total_cost": 0.012609
   }
}```

What's included?
- `input_tokens_cost`: Cost attributed to input tokens.
- `output_tokens_cost`: Cost attributed to output tokens.
- `request_cost`: Fixed cost per request.
- `total_cost`: The total cost for this API call.

**Learn more here: https://docs.perplexity.ai/changelog/changelog#july-2025**

<@&1256984878138920981>

[last tartan]

Another announcement coming for you guys! We're excited to share that after a little construction....

**The Perplexity Sonar Cookbook is now LIVE and accepting contributions! **

Want to share your guide, hack, or demo with the whole Perplexity community? All you have to do is:

• Make a Pull Request with a new example, showcase, or article/guide to share
• If your PR is accepted, your work gets featured inside our docs page!

This is your opportunity to inspire devs everywhere, build your profile, and have your work permanently showcased.

🔗 Get started: https://github.com/ppl-ai/api-cookbook
<@&1256984878138920981>

[last tartan]

Hey everyone! We just published updated instructions for website owners on allowing Perplexity’s crawlers and configuring AWS WAF correctly.

What’s inside:

• How PerplexityBot and Perplexity‑User work and when they’re used
• Exact user-agent strings and published IP ranges
• Recommended robots.txt settings
• AWS WAF rules: allowlisting tips, CIDR updates, common pitfalls

If you manage a site or API and want Perplexity to surface your content reliably, this guide should help you get set up quickly.

Read the guide: https://docs.perplexity.ai/guides/bots

<@&1256984878138920981>

[wintry badge]

<@&1256984878138920981>
No more trying to remember where this API key is being used, you can now name API keys directly in the portal! 🔐

Please let us know what other frontend improvements you would like to see in #1161804761247526912, a lot more coming soon!

[wintry badge]

📢 New Sonar API Updates

Two improvements are live today:

1. Expanded domain filters
You can now include up to 20 entries in search_domain_filter (previously 10).
More flexibility for allowlisting or denylisting sources in your queries!

2. Snippets in search_results
Each item in the search_results array now includes a snippet (short summary/description), just like you’d see in a search engine!

Example
If I were to prompt: "What is Comet by Perplexity?"

The response would include search_results like:

"search_results": [
  {
    "title": "Comet: Perplexity's AI browser gets personal - IBM Think",
    "url": "https://www.ibm.com/think/news/comet-perplexity-take-agentic-browser",
    "date": "2025-07-18",
    "last_updated": "2025-07-18",
    "snippet": "With the launch of Comet, Perplexity is tackling a new challenge: reinventing how everyday users interact with the web ..."
  }
]

<@&1256984878138920981>

[wintry badge]

📢 New API Beta Release — Search API <@&1256984878138920981>

Hi everyone!
We’re excited to share the first beta release of our Search API, now available through our brand new Python and TypeScript SDKs.

📘 Docs: Click Here

Our developer community is our biggest asset. To incorporate your feedback, we’re making the Search API free during beta!

🔑 How to get access:
Please tag or DM @wintry badge or @grim patrol to receive a free API key. (Keys are shared individually — please don’t distribute them outside this server.)

💬 Feedback:
We’d love your thoughts and bug reports — share them in #🤖│search-api-testing

Looking forward to seeing what you build with it!

– The Perplexity API Team

---

UPDATE: This beta has now ended

[wintry badge]

You can now upload documents and ask Sonar to analyze them — then instantly cross-reference findings with live web search.

Get answers grounded in your data and the latest facts.
<@&1256984878138920981>

[wintry badge]

New in the Perplexity Search API — you can now filter searches by specific domains.

Query only trusted sources like to get focused, verifiable results.
<@&1256984878138920981>

[wintry badge]

<@&1256984878138920981> Are you using the Perplexity Search API (or trying it out via MCPs/agents/LLM pipelines)? We’d love to hear what’s working well and what’s getting in the way.

Share feedback here (~2 mins): https://perplexity.typeform.com/to/kRoFK6ue

Thanks — it goes directly to product & engineering