diff --git a/docs/tools/perplexity-search.md b/docs/tools/perplexity-search.md
index 41001325ab7..07752345006 100644
--- a/docs/tools/perplexity-search.md
+++ b/docs/tools/perplexity-search.md
@@ -112,8 +112,14 @@ These parameters apply to the native Perplexity Search API path.
 | `max_tokens`          | Total content budget (default: 25000, max: 1000000)  |
 | `max_tokens_per_page` | Per-page token limit (default: 2048)                 |
 
-For the legacy Sonar/OpenRouter compatibility path, only `query` and `freshness` are supported.
-Search API-only filters such as `country`, `language`, `date_after`, `date_before`, `domain_filter`, `max_tokens`, and `max_tokens_per_page` return explicit errors.
+For the legacy Sonar/OpenRouter compatibility path:
+
+- `query`, `count`, and `freshness` are accepted
+- `count` is compatibility-only there; the response is still one synthesized
+  answer with citations rather than an N-result list
+- Search API-only filters such as `country`, `language`, `date_after`,
+  `date_before`, `domain_filter`, `max_tokens`, and `max_tokens_per_page`
+  return explicit errors
 
 **Examples:**
 
@@ -168,6 +174,7 @@ await web_search({
 
 - Perplexity Search API returns structured web search results (`title`, `url`, `snippet`)
 - OpenRouter or explicit `plugins.entries.perplexity.config.webSearch.baseUrl` / `model` switches Perplexity back to Sonar chat completions for compatibility
+- Sonar/OpenRouter compatibility returns one synthesized answer with citations, not structured result rows
 - Results are cached for 15 minutes by default (configurable via `cacheTtlMinutes`)
 
 ## Related
diff --git a/docs/tools/web.md b/docs/tools/web.md
index 3bf54472a2c..6d4437ac993 100644
--- a/docs/tools/web.md
+++ b/docs/tools/web.md
@@ -275,6 +275,9 @@ show the `x_search` prompt.
   Gemini, Grok, and Kimi return one synthesized answer with citations. They
   accept `count` for shared-tool compatibility, but it does not change the
   grounded answer shape.
+  Perplexity behaves the same way when you use the Sonar/OpenRouter
+  compatibility path (`plugins.entries.perplexity.config.webSearch.baseUrl` /
+  `model` or `OPENROUTER_API_KEY`).
   Firecrawl and Tavily only support `query` and `count` through `web_search`
   -- use their dedicated tools for advanced options.
 </Warning>