> For clean Markdown of any page, append `.md` to the page URL.
> Documentation index: https://you.com/docs/llms.txt (section indexes: append `/llms.txt` to any section URL).
> Search these docs: Docs MCP at https://you.com/docs/_mcp/server (`searchDocs`, no API key).
> Call live You.com APIs: Product MCP at https://api.you.com/mcp (free Search only: `?profile=free`). To pick an API or integration path, call `you-discover` on that server instead of guessing.
> OpenAPI: https://you.com/docs/openapi.json—auth header `X-API-Key`, env `YDC_API_KEY`.

# Finance Research API Quickstart

The Finance Research API works like the [Research API](/docs/guides/research)—same request shape, same response shape—but it searches a finance-optimized index instead of the open web: SEC filings, equity prices, fundamentals, macro indicators, and financial news.

Get an API key at [you.com/platform](https://you.com/platform). New accounts start with \$100 in complimentary credits. The samples below read `YDC_API_KEY`. See the [site Quickstart](/docs/quickstart) for the five-API tour and [API key management](/docs/administration/api-keys) for best practices.

```python maxLines=0
from youdotcom import You
from youdotcom.models import FinanceResearchEffort

with You() as you:
    res = you.finance_research(
        input="What were the key drivers of NVIDIA's revenue growth in fiscal year 2025?",
        research_effort=FinanceResearchEffort.DEEP,
    )

    print(res.output.content)

    for i, source in enumerate(res.output.sources, 1):
        print(f"[{i}] {source.title or 'Untitled'}: {source.url}")
```

```typescript
const response = await fetch("https://api.you.com/v1/finance_research", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.YDC_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    input: "What were the key drivers of NVIDIA's revenue growth in fiscal year 2025?",
    research_effort: "deep",
  }),
});

if (!response.ok) {
  throw new Error(`HTTP error: ${response.status}`);
}

const data = await response.json();

console.log(data.output.content);

(data.output.sources as { title?: string; url: string }[]).forEach((s, i) => {
  console.log(`[${i + 1}] ${s.title ?? "Untitled"}: ${s.url}`);
});
```

```curl
curl -X POST https://api.you.com/v1/finance_research \
  -H "X-API-Key: $YDC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "What were the key drivers of NVIDIA'\''s (NVDA) revenue growth in fiscal year 2025?",
    "research_effort": "deep"
  }'
```

It accepts two parameters: `input` (your financial question) and `research_effort` (`deep` or `exhaustive`). It does not support `source_control` or `output_schema`. If you need domain filtering or structured JSON, use the [Research API](/docs/guides/research).

## Next Steps

#### [Finance Research API Overview](/docs/guides/finance-research)

The finance index, effort levels, use cases, and pricing

#### [API reference](/docs/api-reference/finance-research/v1-finance_research)

Full parameter reference, request/response schemas, and playground

#### [Research API](/docs/guides/research)

General-purpose research with source controls and structured output

#### [Site Quickstart](/docs/quickstart)

Try all five APIs in one tour