Skip to main content

Research Results

The research route accepts a natural-language query and returns the available Google Finance research payload for that query:

curl "https://api.gfin.dev/v1/research?q=What%20are%20Apple's%20latest%20earnings%20highlights%3F"

SDKs expose the same route:

client.research("What are Apple's latest earnings highlights?")
await client.research("What are Apple's latest earnings highlights?");

Query Requirements​

/v1/research requires one of:

  • q
  • query
  • term

If no query is provided, gfin returns 400 bad_request.

Handling Output​

Research responses may include prose, citations, structured fragments, and source-provided arrays. Keep the response envelope and log request_id so you can trace user-facing research answers.

For agent workflows:

  • Pass the user's exact question as q.
  • Show that research output may change over time.
  • Use refresh=1 only for explicit latest-data actions.
  • Do not treat research output as investment advice.