> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep Research

> AI-powered research with comprehensive reports and citations

## Authentication

Requires x402 payment proof in the `X-Payment-Proof` header.

## Request Body

<ParamField body="topic" type="string" required>
  Research topic or question
</ParamField>

<ParamField body="depth" type="string" optional default="quick">
  Research depth: `quick` or `deep`
</ParamField>

<Snippet file="audit-context-params.mdx" />

## Response

<ResponseField name="request_id" type="string">
  Job ID for tracking research progress
</ResponseField>

<ResponseField name="status" type="string">
  Job status: `pending`, `processing`, `completed`, or `failed`
</ResponseField>

<ResponseField name="message" type="string">
  Status message
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://win.oneshotagent.com/v1/tools/research \
    -H "Content-Type: application/json" \
    -H "X-Payment-Proof: <your_x402_signature>" \
    -d '{
      "topic": "Latest developments in AI agent frameworks",
      "depth": "deep"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://win.oneshotagent.com/v1/tools/research", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "X-Payment-Proof": paymentProof,
    },
    body: JSON.stringify({
      topic: "Latest developments in AI agent frameworks",
      depth: "deep",
    }),
  });
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "request_id": "req_research_xyz",
    "status": "pending",
    "tool": "research",
    "message": "Job queued successfully."
  }
  ```
</ResponseExample>

## Research Depths

* **quick**: Fast research with 5-10 sources (2-3 minutes)
* **deep**: Comprehensive research with 20+ sources (5-10 minutes)

## Notes

* Results include markdown report with citations
* Sources are verified and ranked by relevance
* Job status can be polled using the `request_id`