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

# Deep Research API

> Generate comprehensive, long-form research reports on any crypto topic using Messari's knowledge graph.

The Deep Research API enables you to generate in-depth research reports asynchronously. Each report is backed by Messari's knowledge graph and includes cited sources.

## How It Works

Deep research jobs run asynchronously and typically take **5-10 minutes** to complete. The workflow is:

1. **Create a job** — Submit a research query via [POST /ai/v1/deep-research](/api-reference/endpoints/ai/post-v1-deep-research)
2. **Poll for status** — Check progress via [GET /ai/v1/deep-research/{id}](/api-reference/endpoints/ai/get-v1-deep-research-id) until status is `completed`
3. **Retrieve the report** — The completed response includes the full markdown report and cited sources

### Job Statuses

| Status        | Description                                |
| ------------- | ------------------------------------------ |
| `queued`      | Job is waiting to be processed             |
| `in_progress` | Research generation is underway            |
| `completed`   | Report is ready — check the `output` field |
| `failed`      | Job failed — check the `error` field       |
| `cancelled`   | Job was cancelled via the cancel endpoint  |

## Endpoints

* [Create Deep Research Job](/api-reference/endpoints/ai/post-v1-deep-research) — Start a new research report
* [List Deep Research Jobs](/api-reference/endpoints/ai/get-v1-deep-research) — View your research jobs with pagination and status filtering
* [Get Deep Research Job](/api-reference/endpoints/ai/get-v1-deep-research-id) — Poll for status and retrieve completed reports
* [Cancel Deep Research Job](/api-reference/endpoints/ai/post-v1-deep-research-id-cancel) — Cancel a queued or in-progress job

## Follow-up Research

You can iteratively refine a report by passing the original `job_id` in a subsequent create request. This sends a follow-up message to the same research conversation, allowing you to ask clarifying questions or request additional analysis on the same topic.

## Authorization

Refer to our [Authentication](/api-reference/authentication) docs for creating an API key.

### Credits

Each deep research request consumes **500 credits**. Enterprise teams receive **10 free report generations per month** — these are shared across the Messari platform and API, and are consumed before credits are deducted.