Research

Reka Research

Reka Research gives your app access to real-time web results in one call. Built for developers who need answers that are accurate, auditable, and grounded in evidence.

Fully compatible with OpenAI’s /chat/completions format — including streaming and structured JSON. Swap in our model with minimal changes to your code.

How to use

  1. Use an official OpenAI SDK
  2. Change the following
    • Update your base URL to point to Reka’s API
    • Replace your API key with an Reka API key
    • Update your model name to use reka-flash-research

Here’s how to do this in Python, TypeScript, and Shell.

1from openai import OpenAI
2
3client = OpenAI(
4    base_url="https://api.reka.ai/v1",
5    api_key=API_KEY
6)
7
8completion = client.chat.completions.create(
9    model="reka-flash-research",
10    messages=[
11      {
12          "role": "user",
13          "content": (
14              "Check for new or updated IRS tax-compliance regulations or guidance issued in the past 7 days.\n\n"
15              "List:\n- Title of update\n- Date issued\n- Summary of key changes\n- Link to official IRS source"
16          )
17      },
18  ]
19)

Response

Example response

Output
1{
2  "id": "04cfb2c3-acf3-4756-bc96-9665bf1b7d93",
3  "choices": [
4    {
5      "finish_reason": "stop",
6      "index": 0,
7      "logprobs": null,
8      "message": {
9        "content": "Here are IRS tax-compliance updates from the past 7 days (June 16–23, 2025):\n\n...",
10        "role": "assistant",
11        "annotations": [
12          {
13            "type": "url_citation",
14            "url_citation": {
15              "end_index": 404,
16              "start_index": 333,
17              "title": "News releases for current month | Internal Revenue Service",
18              "url": "https://www.irs.gov/newsroom/news-releases-for-current-month"
19            }
20          },
21          ...
22        ],
23        "audio": null,
24        "function_call": null,
25        "tool_calls": null,
26        "reasoning_content": "All relevant IRS updates from the past 7 days (June 16–23, 2025) have been identified in the analysis...",
27        "reasoning_steps": [
28          {
29            "role": "assistant",
30            "content": null,
31            "reasoning_content": "I'll search for IRS tax updates from the past 7 days to find official documents with required details like titles, dates, and summaries.",
32            "tool_calls": [
33              {
34                "name": "search_web",
35                "args": { "query": "IRS tax updates past 7 days" }
36              }
37            ],
38            "tool_call_id": null
39          },
40          {
41            "role": "tool",
42            "content": {
43              "tool_name": "search_web",
44              "tool_output": [
45                {
46                  "url": "https://www.irs.gov/newsroom/tax-updates-and-news-from-the-irs",
47                  "title": "Tax updates and news from the IRS",
48                  "snippet": "Get critical updates that may affect your tax filing and recent IRS news. On this page. Filing; Inflation adjustments; COVID-era tax credits; Disaster tax ...",
49                  "age": null
50                },
51                ...
52              ],
53              "tool_error": null
54            },
55            "reasoning_content": null,
56            "tool_calls": null,
57            "tool_call_id": "56b41dc5-0e3b-453e-91de-dbcc987d1c23"
58          },
59          {
60            "role": "assistant",
61            "content": null,
62            "reasoning_content": "Analyze IRS newsroom and recent releases to identify updates from the past 7 days with required details.",
63            "tool_calls": [
64              {
65                "name": "analyze",
66                "args": {
67                  "urls": [
68                    "https://www.irs.gov/newsroom/tax-updates-and-news-from-the-irs",
69                    "https://www.irs.gov/newsroom/news-releases-for-current-month"
70                  ],
71                  "task": "Extract Title, Issue Date (within last 7 days), Key Changes Summary, and Official IRS Link for each regulation/guidance update."
72                }
73              }
74            ],
75            "tool_call_id": null
76          },
77          {
78            "role": "tool",
79            "content": {
80              "tool_name": "analyze",
81              "tool_output": [
82                {
83                  "url": "https://www.irs.gov/newsroom/tax-updates-and-news-from-the-irs",
84                  "analysis": "Title: Notice 2024-85 - Transition Relief ..."
85                },
86                ...
87              ],
88              "tool_error": null
89            },
90            "reasoning_content": null,
91            "tool_calls": null,
92            "tool_call_id": "0f4beee6-372e-4be6-86bd-828d65255423"
93          }
94        ]
95      }
96    }
97  ],
98  "created": 1750673286,
99  "model": "reka-flash-research",
100  "object": "chat.completion",
101  "service_tier": null,
102  "system_fingerprint": null,
103  "usage": null
104}

Each response includes:

  • Chain-of-thought: Full trace of how the agent searched and reasoned (message.reasoning_steps)
  • Final reasoning: Internal rationale before the answer (message.reasoning_content)
  • Answer: Human-readable output with inline citations (message.content)
  • Citations: Start/end index, title, and URL for every source used

See Reasoning Steps for more information about the reasoning trace.

Citations

Citations are built in. Each one marks exactly where a source is used — with title, URL, and the span in the response it supports. Every url_citation gives you precise auditability, down to the character index.