---
title: "Deep research: shortlist + dossiers + comparison + next step (partner/enterprise key required)"
method: POST
path: "/suppliers/deep-research"
---

# Deep research: shortlist + dossiers + comparison + next step (partner/enterprise key required)

`POST /suppliers/deep-research`

## Request

- Base URL: `https://source.reevol.com/api/v1`
- URL: `https://source.reevol.com/api/v1/suppliers/deep-research`
- Auth: HTTP bearer

Non-streaming equivalent of the /mcp/deep SSE endpoint and the find_and_brief MCP tool. Cached 24h on identical brief + filters.

## Request body

- MatchRequest
  - `brief` string, required: Freeform description of what the buyer is sourcing.
  - `country` string: Single canonical country name.
  - `countries` string[]: Multi-country allow-list.
  - `excludeCountries` string[]
  - `hsCodes` string[]
  - `industry` string
  - `certifications` string[]
  - `employeeRange` string[]
  - `foundedAfter` integer
  - `foundedBefore` integer
  - `businessType` 'manufacturer' | 'trading_company' | 'any'
  - `exportMarkets` string[]
  - `limit` integer
  - `lang` string

## Response `200`

Full deep-research result (shortlist, dossiers, comparison, nextStep, costUsd, cached)

## Other responses

- `403`: Key tier does not allow action tools
- `413`: Payload too large to synthesize within the per-request cost cap

---

[API](https://skmtc.dev/reevol/apis/reevol-source-rest-api.md) · [All operations](https://skmtc.dev/reevol/apis/reevol-source-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reevol/apis/reevol-source-rest-api/revisions/a7a6db37cc5a?raw)