---
title: "Start a multi-source research job."
method: POST
path: "/v1/research"
---

# Start a multi-source research job.

`POST /v1/research`

## Request body

- object
  - `query` string, required
  - `max_sources` integer
  - `deep` boolean — Deprecated: research always runs in deep mode; this flag is ignored.

## Response `200`

Successful response

- object

## Other responses

- `400` — Invalid request
- `401` — Invalid or missing API key
- `402` — Payment required or insufficient credits
- `429` — Rate limit exceeded

## Changes

- **2026-07-26** `bd14a9c72a3b` — 1 info
  - added the new optional request property `deep`

[Change history](https://skmtc.dev/webclaw/apis/webclaw-api/changes/v1/research/post.md)

---

[API](https://skmtc.dev/webclaw/apis/webclaw-api.md) · [All operations](https://skmtc.dev/webclaw/apis/webclaw-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webclaw/webclaw-api/revisions/bd14a9c72a3b/schema)