Confidence-scored multi-source retrieval across web, scholar, Tavily, and Perplexity-backed research. Use when: the user needs cross-source verification, consensus checks, or one report that compares multiple search surfaces. Supports parallel retrieval, confidence scoring, and synthesis-ready outputs.
Confidence-scored multi-source retrieval across web, scholar, Tavily, and Perplexity-backed research. Use when: the user needs cross-source verification, consensus checks, or one report that compares multiple search surfaces. Supports parallel retrieval, confidence scoring, and synthesis-ready outputs.
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar",
"messages": [
{"role": "user", "content": "What changed in the AI agent ecosystem this week?"}
]
}'
Sonar Pro
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-pro",
"messages": [
{"role": "user", "content": "Compare the top browser-use agent frameworks and cite the key differences."}
]
}'
Sonar Reasoning Pro
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-reasoning-pro",
"messages": [
{"role": "user", "content": "Analyze whether small vertical AI agents can defend against general-purpose copilots."}
]
}'
Sonar Deep Research
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-deep-research",
"messages": [
{"role": "user", "content": "Create a deep research report on AI coding agents in 2026, including product categories, pricing, and risks."}
]
}'
# Structured search
python3 scripts/search_client.py web --query "latest AI news" --count 10
python3 scripts/search_client.py scholar --query "transformer architecture" --count 10
python3 scripts/search_client.py smart --query "autonomous agents" --count 10
# Perplexity Sonar family
python3 scripts/search_client.py sonar --query "Summarize this week's AI launches"
python3 scripts/search_client.py sonar-pro --query "Compare AI agent frameworks with citations"
python3 scripts/search_client.py sonar-reasoning-pro --query "Analyze the defensibility of AI copilots"
python3 scripts/search_client.py sonar-deep-research --query "Write a deep research report on AI browser agents"# Optional system instruction
python3 scripts/search_client.py sonar-pro \
--query "Map the top coding agent products" \
--system "Respond in markdown with a short executive summary first."# Tavily utilities
python3 scripts/search_client.py tavily-search --query "AI developments"
python3 scripts/search_client.py tavily-extract --urls "https://example.com/article"# Multi-source retrieval
python3 scripts/search_client.py verity --query "Is quantum computing ready for enterprise?"
API Reference
Endpoint
Method
Description
/scholar/search/web
POST
Web search with structured results
/scholar/search/scholar
POST
Academic paper search
/scholar/search/smart
POST
Hybrid scholar search
/scholar/explain
POST
Generate result explanations
/perplexity/sonar
POST
Lightweight search answers with citations
/perplexity/sonar-pro
POST
Advanced search answers for complex tasks
/perplexity/sonar-reasoning-pro
POST
Analytical reasoning with web search
/perplexity/sonar-deep-research
POST
Exhaustive research reports
/tavily/search
POST
Tavily search integration
/tavily/extract
POST
Extract content from URLs
/tavily/crawl
POST
Crawl web pages
/tavily/map
POST
Generate site maps
Parameters
Scholar search query parameters
Parameter
Type
Description
query
string
Search query
max_num_results
integer
Max results (default 10)
as_ylo
integer
Year lower bound
as_yhi
integer
Year upper bound
Perplexity request body
This skill sends a minimal OpenAI-style payload:
{"model":"sonar-pro","messages":[{"role":"system","content":"Optional system instruction"},{"role":"user","content":"Your question"}]}
Use messages because the AIsa Perplexity endpoints are presented as "Ask AI" endpoints in the official docs. This skill keeps the payload intentionally small for broad compatibility.
Notes
/search/full and /search/smart are no longer documented here because you indicated those nodes have been retired.
The existing scholar and Tavily endpoints remain available.
verity still focuses on parallel retrieval from scholar, web, hybrid scholar, and Tavily sources.
Full API Reference
See API Reference for complete endpoint documentation.
Resources
AIsa Verity - Reference implementation of confidence-scored search agent
