---
title: "Research"
method: POST
path: "/global/research/v1"
tags: ["Global", "Croma"]
---

# Research

`POST /global/research/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/global/research/v1`
- Auth: HTTP bearer

Answer an open question from live sources. Returns a written report in Markdown with numbered citations plus the list of sources behind it. Typically takes a few seconds; it is a research pass, not a lookup, so verify anything you act on against the primary source.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string, required: The question to research, in plain language.

## Response `200`

Successful response

- ResearchReportResponse
  - `data` object, required
    - `query` string, required: Echoes the question asked.
    - `report` string, required: The report in Markdown. Bracketed numbers such as `[1]` index into `sources`.
    - `sources` ResearchSource[], required
      - `title` string, nullable, required
      - `url` string, uri, required
    - `pages_analyzed` integer, required: How many sources the report drew on.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)