You.com Finance Research API

Getting Your API Key: After subscribing, you will receive your API key within 48 hours via the email associated with your AWS Marketplace account. You can also generate and manage keys yourself at any time at you.com/platform/api-keys (Create API Key → copy the key immediately, as it is only shown once).

Authentication All requests require an API key passed in a custom header - this is not a Bearer token:

X-API-Key: <YOUR_API_KEY> Content-Type: application/json There is no OAuth flow or token exchange. The key is a static string generated on the Platform and used directly on every request. Endpoint

POST https://api.you.com/v1/finance_research  Request Body Parameter Type Required Description input string Yes The financial research question (max 40,000 characters) research_effort string No deep (default) or exhaustive. deep: multi-source analysis, <120s latency, $110/1k requests — best for earnings summaries, comparisons, regulatory research. exhaustive: full due-diligence depth, <300s latency, $500/1k requests — best for full 10-K analysis or cross-market research. Example Request (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" }' Response Schema A 200 response returns a JSON object with an output field containing the synthesized, cited answer:

{ "output": { "content": "NVIDIA's fiscal 2025 revenue growth was driven primarily by Data Center accelerated-computing and AI demand: total revenue was $130.5 billion, up 114%...[[1]]", "content_type": "text", "sources": [ { "url": "https://nvidianews.nvidia.com/news/nvidia-announces-financial-results-for-fourth-quarter-and-fiscal-2025 ", "title": "NVIDIA Announces Financial Results for Fourth Quarter and Fiscal 2025" } ] } }

Field Type Description output.content string Markdown-formatted answer with inline citation tags (e.g. [[1]]) referencing the sources array output.content_type string Always "text" output.sources array Each item includes the url and title of a source the API read and cited Error Codes

HTTP Status Code Meaning Example Body 401 unauthorized Missing, invalid, or expired API key {"detail": "API key is required"} or {"detail": "Invalid or expired API key"} 402 payment_required Account has run out of credits {"detail": "Insufficient credits"} 403 forbidden API key lacks the required scope for this endpoint {"detail": "Missing required scopes"} 404 agent_not_found / agent_not_supported_yet Referenced agent/resource does not exist or is unsupported — 422 invalid_request Invalid or conflicting request parameters {"error": "invalid request parameter(s)"} 429 rate_limited Too many requests sent in a given period; back off and retry after the interval indicated by the response {"detail": "Rate limit exceeded"} 500 Internal Server Error Failure in auth/authorization middleware or an unexpected server-side error {"detail": "Internal authentication error"} For the complete, most current error reference, see you.com/docs/error-handling/error-code-reference.

Notes

The Finance Research API queries a finance-optimized index (earnings, SEC filings, analyst coverage, market/macro data) rather than the open web, and does not support source_control or output_schema — use the general Research API if you need domain filtering or structured JSON output. All new accounts receive $100 in free credits. Full quickstart, SDKs (Python, TypeScript), and MCP/framework integrations: you.com/docs/finance-research/overview