Search & Summarize
Search + AI summarization in one API call.
Answers & researchFree demo, no keyLong-running: consider /v1/jobs
POST/v1/search-and-summarize/5 credits
curl -X POST https://api.hushsearch.io/v1/search-and-summarize/ \
-H "X-API-Key: hs_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "latest stable Python release notes",
"num_results": 5
}'Combines real-time web search with AI summarization (via Groq Llama). One call returns both raw results AND a synthesized, source-cited summary. Perfect for research assistants and Q&A bots.
Request
curl -X POST https://api.hushsearch.io/v1/search-and-summarize/ \
-H "X-API-Key: hs_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "What is retrieval augmented generation and when should I use it?",
"num_results": 5
}'Parameters
Same as /v1/search/ — all search parameters are supported.
Response
{
"summary": "Retrieval-Augmented Generation (RAG) is a technique that combines information retrieval with language model generation [1]. It's best used when you need up-to-date information not in the model's training data [2]...",
"results": [
{
"title": "RAG Explained — AWS Blog",
"url": "https://aws.amazon.com/what-is/retrieval-augmented-generation/",
"snippet": "RAG is an AI framework..."
}
],
"credits_used": 5,
"credits_remaining": 490,
"response_time_ms": 2850
}Python Example
import requests
response = requests.post(
"https://api.hushsearch.io/v1/search-and-summarize/",
headers={"X-API-Key": "hs_live_..."},
json={
"query": "How does Apple Intelligence work on iPhone?",
"num_results": 5,
"categories": ["general", "it"]
}
)
data = response.json()
print("Summary:")
print(data["summary"])
print("\nSources:")
for r in data["results"]:
print(f" - {r['title']}: {r['url']}")Note on AI Summarization
The summary uses Groq's llama3-8b-8192 model. If GROQ_API_KEY is not configured, the endpoint still returns results with a fallback message in the summary field.