search_advanced
Search Perplexity across web, academic, and social sources with claim-level citations, then optionally verify each cited fact against its source page. Returns provenance, dates, and verifiable snippets.
Instructions
Search Perplexity.ai with specific source selection (web, academic, social), claim-level citation provenance ([1] markers, snippets, dates), optional live claim-source verification, local caching, cancellation-safe streaming, progress notifications, partial .txt checkpoints, typed error JSON, poolable browser profiles, and optional official Agent API backend.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>",
"sources": "<sources>"
},
"name": "search_advanced"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional Perplexity model name (e.g. 'Best', 'GPT-6.1 Sol', 'Grok 4.7', 'Claude Sonnet 5.5', 'Gemini 4 Hydrogen', or 'sonar' for API backend). Omit to use the currently selected model. | |
| query | Yes | The search query | |
| backend | No | Execution backend: 'auto' (uses official Perplexity Agent API if PERPLEXITY_API_KEY is configured and thread_url is omitted, otherwise browser Pro session), 'browser' (Playwright Pro UI), or 'api' (official HTTPS Agent API). | |
| profile | No | Optional browser profile name or directory path for isolated/concurrent execution (e.g. 'default', 'worker-2'). When omitted, automatically routes to an idle slot in PERPLEXITY_PROFILE_DIRS / default profile. | |
| sources | Yes | Sources to search: 'web' (general web), 'academic' (scholarly articles), 'social' (Reddit & forums). Can combine multiple. | |
| no_cache | No | If true, bypasses the local response cache (default TTL 3600s, configurable via PERPLEXITY_CACHE_TTL_SECONDS) and forces a fresh search. | |
| thread_url | No | Optional Perplexity thread URL returned by a previous search to ask a follow-up in the same conversation (browser backend). | |
| output_file | No | Optional .txt file path to save the full answer to (regardless of length). Relative paths resolve inside the server's outputs directory. When omitted, answers at or above 15000 chars (configurable via PERPLEXITY_LONG_OUTPUT_CHARS) are automatically saved to a .txt file with an inline preview and path. | |
| verify_claims | No | If true (or PERPLEXITY_VERIFY_CLAIMS=1), fetches cited pages and checks key facts (numbers, dates, versions, names) for each claim, marking supported / weak / unverified. | |
| timeout_seconds | No | Optional timeout in seconds for waiting on the answer (defaults to server timeout, 900s / 15 minutes; max 1800s for very large code or multi-part responses). |