Skip to main content

Research

Use research for natural-language finance questions.

curl "https://api.gfin.dev/v1/research?q=What%20are%20Apple's%20latest%20earnings%20highlights%3F" \
  -H "X-Gfin-Contact: you@example.com"
answer = client.research("What are Apple's latest earnings highlights?")
const answer = await client.research("What are Apple's latest earnings highlights?");

Good Queries​

Use specific, bounded questions:

What are Apple's latest earnings highlights?
Why is AAPL moving today?
Summarize recent Microsoft stock news.
What are the key risks mentioned for Nvidia?

Production Handling​

  • Keep meta.request_id in logs.
  • Display that output may change as Google Finance updates.
  • Use retries only for temporary errors.
  • Use refresh=1 only when the user asks for a fresh research run.
  • Do not present research output as investment advice.