---
title: "Creates an asynchronous research task that performs comprehensive multi-step web research. Returns a task ID immediately. Poll GET /research/:id for results."
method: POST
path: "/linkup/research"
tags: ["Linkup"]
---

# Creates an asynchronous research task that performs comprehensive multi-step web research. Returns a task ID immediately. Poll GET /research/:id for results.

`POST /linkup/research`

## Request

- Base URL: `https://api.orthogonal.com/mpp`
- URL: `https://api.orthogonal.com/mpp/linkup/research`
- Auth: none declared
- TypeScript: <https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/docs/linkup/research/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- object
  - `q` string, required: The natural language question for which you want to perform research.
  - `outputType` string, required: The type of output. Use sourcedAnswer for a sourced text answer, or structured for a custom-formatted response defined by structuredOutputSchema.
  - `reasoningDepth` string: Pin the reasoning depth (S < M < L < XL). Defaults to L. Higher depths trade latency for thoroughness.
  - `mode` string: Pin the research agent mode: answer, investigate, research, or auto (default). Omit to let the agent auto-classify.
  - `structuredOutputSchema` object: Required only when outputType is structured. JSON schema representing the desired response format. Root must be type object.
  - `fromDate` string: Start date for results in ISO 8601 format (YYYY-MM-DD).
  - `toDate` string: End date for results in ISO 8601 format (YYYY-MM-DD).
  - `includeDomains` string[]: Domains to restrict search to. Up to 100 domains.
  - `excludeDomains` string[]: Domains to exclude from search.

## Response `200`

Successful response

## Other responses

- `402`: Payment Required (x402 / MPP / np)

## Changes

- **2026-11-08** `857e915717f4`: 1 breaking
  - added required request body
- **2026-09-25** `7b9ef1bbf41c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/changes/linkup/research/post.md)

---

[API](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace.md) - [All operations](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/llms.txt) - [OpenAPI document](https://skmtc.dev/orthogonal/apis/orthogonal-api-marketplace/revisions/857e915717f4?raw)