curl -X POST https://win.oneshotagent.com/v1/tools/research \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"topic": "Latest developments in AI agent frameworks",
"depth": "deep"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/research", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
topic: "Latest developments in AI agent frameworks",
depth: "deep",
}),
});
{
"request_id": "req_research_xyz",
"status": "pending",
"tool": "research",
"message": "Job queued successfully."
}
Research & Enrich
Deep Research
Research a topic and get a report with citations
POST
/
v1
/
tools
/
research
curl -X POST https://win.oneshotagent.com/v1/tools/research \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"topic": "Latest developments in AI agent frameworks",
"depth": "deep"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/research", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
topic: "Latest developments in AI agent frameworks",
depth: "deep",
}),
});
{
"request_id": "req_research_xyz",
"status": "pending",
"tool": "research",
"message": "Job queued successfully."
}
Researches a topic or question and returns a markdown report with citations. The call is async: it returns a job ID, and you poll for the report. Choose quick or deep depth.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
Topic or question to research
string
default:"quick"
Research depth:
quick or deepResponse
string
Job ID for polling progress
string
Job status:
pending, processing, completed, or failedstring
Status message
curl -X POST https://win.oneshotagent.com/v1/tools/research \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"topic": "Latest developments in AI agent frameworks",
"depth": "deep"
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/research", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
topic: "Latest developments in AI agent frameworks",
depth: "deep",
}),
});
{
"request_id": "req_research_xyz",
"status": "pending",
"tool": "research",
"message": "Job queued successfully."
}
Research Depths
quick: 5-10 sources, 2-3 minutesdeep: 20+ sources, 5-10 minutes
Notes
- The result is a markdown report with citations
- Sources are verified and ranked by relevance
- Poll job status with the
request_id