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.