Skip to main content
View on GitHub → Multi-source intelligent retrieval for autonomous agents. One AISA_API_KEY unlocks structured web search, academic paper lookup, Tavily extraction/crawling, and the full Perplexity Sonar family for citation-rich answers.

​
Install

aisa skills install multi-source-search

​
What can agents do with it?

Fast web lookup

“Summarize the latest AI infrastructure launches this month.”

Scholar-backed research

“Find recent academic papers on self-correcting agent frameworks.”

Citation-rich answers

“Answer this question with inline citations using Perplexity Sonar Pro.”

Deep research reports

“Generate a 2,000-word report on autonomous browser agents.”

Content extraction

“Pull the main article text from these 5 URLs for analysis.”

Site intelligence

“Map the structure of this docs site and crawl it for RAG.”

​
Core capabilities

  • Web search (/scholar/search/web) — structured web results for current information
  • Scholar search (/scholar/search/scholar) — academic papers with optional date filtering
  • Smart/hybrid search (/scholar/search/mixed) — combines web + scholar in one call
  • Explain search (/scholar/explain) — explanatory synthesis over results
  • Perplexity Sonar family — sonar, sonar-pro, sonar-reasoning-pro, sonar-deep-research
  • Tavily — search, extract, crawl, map
  • Verity multi-source — parallel retrieval across source types

​
Quick start

export AISA_API_KEY="your-key"

​
Web + scholar

# Structured web search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI infrastructure launches 2026"}'

# Academic papers
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "self-correcting agent frameworks"}'

# Smart hybrid (web + scholar)
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/mixed" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "retrieval-augmented generation"}'

​
Perplexity Sonar

# Fast answers
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 is MCP?"}]}'

# 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": "State of agentic payments in 2026"}]}'

​
Tavily utilities

# Search
curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "LLM agent frameworks"}'

# Extract clean article text
curl -X POST "https://api.aisa.one/apis/v1/tavily/extract" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/article"]}'

# Recursive crawl
curl -X POST "https://api.aisa.one/apis/v1/tavily/crawl" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "depth": 2}'

# Site map
curl -X POST "https://api.aisa.one/apis/v1/tavily/map" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

​
Python client

# Web + scholar + smart
python3 scripts/search_client.py web --query "AI agent news"
python3 scripts/search_client.py scholar --query "self-correcting agents"
python3 scripts/search_client.py smart --query "RAG patterns"

# Perplexity
python3 scripts/search_client.py sonar --query "What is MCP?"
python3 scripts/search_client.py sonar-pro --query "Compare OpenRouter vs AIsa"
python3 scripts/search_client.py sonar-reasoning-pro --query "Analyze x402 adoption"
python3 scripts/search_client.py sonar-deep-research --query "State of agentic payments"

# Tavily
python3 scripts/search_client.py tavily-search --query "LLM agents"
python3 scripts/search_client.py tavily-extract --urls "https://example.com/article"
python3 scripts/search_client.py tavily-crawl --url "https://example.com" --depth 2
python3 scripts/search_client.py tavily-map --url "https://example.com"

# Multi-source parallel retrieval
python3 scripts/search_client.py verity --query "AI agent benchmarks 2026"

​
Endpoint reference

EndpointMethodPurpose
/scholar/search/webPOSTWeb search
/scholar/search/scholarPOSTAcademic papers
/scholar/search/mixedPOSTSmart hybrid search
/scholar/explainPOSTExplain search
/perplexity/sonarPOSTSonar — fast answers
/perplexity/sonar-proPOSTSonar Pro — synthesis
/perplexity/sonar-reasoning-proPOSTSonar Reasoning Pro
/perplexity/sonar-deep-researchPOSTSonar Deep Research
/tavily/searchPOSTTavily search
/tavily/extractPOSTTavily extract
/tavily/crawlPOSTTavily crawl
/tavily/mapPOSTTavily map

​
Get started

  1. Sign up at aisa.one (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. export AISA_API_KEY="your-key" and install the skill: 
    aisa skills install multi-source-search

Search API reference

Tavily search, extract, crawl, map — with live playgrounds.

Scholar API reference

Web, scholar, smart, and explain endpoints.

Perplexity API reference

Full Sonar family endpoint docs.