You.com Finance Research API Quickstart

The Finance Research API works like the Research API—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. The samples below read YDC_API_KEY. See the site Quickstart for the five-API tour and API key management for best practices.

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, MCP, or the Python SDK

TypeScript and JavaScript have three paths. Use fetch against the REST APIs when the application needs the JSON. Use @youdotcom-oss/mcp, or the hosted server at https://api.you.com/mcp, when an agent should call the tools. Use the Python SDK when you want a typed client that tracks new API fields. The @youdotcom-oss/sdk package is deprecated.

It accepts input (your financial question), research_effort (deep or exhaustive), and an optional output_schema that returns output.content as a JSON object matching your schema. It does not support source_control. If you need domain filtering, use the Research API.

Next Steps

Finance Research API Overview

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

API reference

Full parameter reference, request/response schemas, and playground

Research API

General-purpose research with source controls and structured output

Site Quickstart

Try all five APIs in one tour