Skip to main content
Plugin ID: perplexity | Auth: API Key (Bearer token)

Tools

Name: Web Search Search the web using Perplexity Sonar and get an AI-synthesized answer with citations. Use for current events, research, fact-checking, or any question that benefits from live web data. Input:
ParameterTypeRequiredDefaultDescription
querystringYesThe search query or question
modelstringNo"sonar""sonar", "sonar-pro", "sonar-reasoning-pro", or "sonar-deep-research"
system_promptstringNoSystem prompt to guide response style
search_domain_filterstring[]NoDomains to include/exclude (prefix with - to exclude)
search_recency_filterstringNo"hour", "day", "week", or "month"
search_context_sizestringNo"medium""low", "medium", or "high"
return_related_questionsbooleanNofalseReturn follow-up question suggestions
max_tokensintegerNoMax output tokens
Output:
{
  "answer": "According to recent reports [1], the market has...",
  "citations": ["https://example.com/article1", "https://example.com/article2"],
  "search_results": [
    { "title": "Market Report 2026", "url": "https://example.com/article1", "snippet": "The market grew by..." }
  ],
  "related_questions": ["What are the key drivers?"],
  "model": "sonar",
  "usage": { "prompt_tokens": 50, "completion_tokens": 200, "total_tokens": 250 }
}

perplexity.chat

Name: Web Search Chat Multi-turn chat with Perplexity Sonar. Provide conversation history for follow-up questions that maintain context from previous search results. Input:
ParameterTypeRequiredDefaultDescription
messagesarrayYesConversation history ({ role, content } objects)
modelstringNo"sonar"Model to use
search_domain_filterstring[]NoDomain filters
search_recency_filterstringNoRecency filter
search_context_sizestringNo"medium"Context size
max_tokensintegerNoMax output tokens
Output:
{
  "answer": "Building on the previous search...",
  "citations": ["https://example.com/follow-up"],
  "search_results": [{ "title": "...", "url": "...", "snippet": "..." }],
  "model": "sonar",
  "usage": { "prompt_tokens": 150, "completion_tokens": 300, "total_tokens": 450 }
}