---
source_url: "https://you.com/docs/api-reference/finance-research/v1-finance_research/?utm_source=openai"
title: "Finance Research | You.com | Documentation"
mirrored_at: 2026-08-30T15:03:04.818Z
host: you.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/you.com/docs/api-reference/finance-research/v1-finance_research/index__q__utm_source_openai"
---

> **Original source:** https://you.com/docs/api-reference/finance-research/v1-finance_research/?utm_source=openai

## Finance Research

The Finance Research API is purpose-built for financial questions. Like the Research API, it runs multiple searches, reads through sources, and synthesizes everything into a thorough, well-cited answer — but its retrieval index is optimized for financial data: earnings reports, SEC filings, analyst coverage, market data, and financial news. Use it when you need credible, sourced answers to financial questions: company fundamentals, market trends, competitive analysis, earnings summaries, or macroeconomic research.

### Authentication

X-API-Keystring

A unique API Key is required to authorize API access. \[Get your API Key with free credits\](https://you.com/platform).

### Request

This endpoint expects an object.

inputstringRequired`<=40000 characters`

The financial research question or complex query requiring in-depth investigation and multi-step reasoning.

Note: The maximum length of the input is 40,000 characters.

research\_effortenumOptionalDefaults to `deep`

Controls how much time and effort the Finance Research API spends on your question. Higher effort levels run more searches and dig deeper into sources, at the cost of a longer response time. Available levels: - \`deep\`: The default. Spends more time researching and cross-referencing sources. Good for most financial questions, including multi-company comparisons, earnings analysis, and regulatory research. - \`exhaustive\`: The most thorough option. Explores the topic as fully as possible, best suited for complex financial research tasks where you want the highest quality result.

Allowed values:

### Response

A JSON object containing a comprehensive finance-grade answer with citations and supporting search results

outputobject

The research output containing the answer and sources.

### Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error