Web Search Configuration

Reka Research adds real-time web results to your AI app — so answers stay fresh, relevant, and grounded in current information.

Web search is on by default. Use these parameters to control how and where your agent searches:

1
web_search: {
2
  // Optional: Max number of web searches per request
3
  max_uses: 10,
4
5
  // Optional: Only search from these domains
6
  allowed_domains: ["example.com", "safe_domain.org"],
7
8
  // Optional: Exclude results from these domains
9
  blocked_domains: ["unsafe_domain.com"],
10
11
  // Optional: Search from this location
12
  user_location: {
13
    city: "San Francisco",
14
    region: "CA",
15
    country: "US",
16
    timezone: "America/Los_Angeles",
17
  }
18
}

Limit usage

Use max_uses to limit how many searches the agent can run per request. Once the limit’s reached, it reason based on with what it has.

1
completion = client.chat.completions.create(
2
    model="reka-flash-research",
3
    messages=[
4
        {
5
            "role": "user",
6
            "content": "Who won the UEFA Nations League 2025?",
7
        },
8
    ],
9
    extra_body={
10
        "research": {
11
            "web_search": {
12
                "max_uses": 3,
13
            },
14
        }
15
    },   
16
)

Filter sources

Choose where the agent can — or can’t — search:

• allowed_domains: Only search from this list
• blocked_domains: Never search from this list

1
completion = client.chat.completions.create(
2
    model="reka-flash-research",
3
    messages=[
4
        {
5
            "role": "user",
6
            "content": "Who won the UEFA Nations League 2025?",
7
        },
8
    ],
9
    extra_body={
10
        "research": {
11
            "web_search": {
12
                "allowed_domains": ["espn.com", "uefa.com"],
13
            },
14
        }
15
    },   
16
)

Domain filtering

Control where your agent is allowed to search — and where it isn’t.

• Use plain domains: Skip http://, https://, or www. — just write example.com.
• Top-level filtering: Listing nytimes.com applies to all its subdomains too.
• One list only: You can’t use allowed_domains and blocked_domains at the same time — doing so will trigger a validation error.

Performance impact

• Filtering adds minimal overhead — but may slightly increase response time.
• Fewer domains mean fewer results. Be mindful: strict filters can reduce answer quality.

Set user location

Use user_location to set where the agent searches from. This helps it find local results and understand context better.

1
completion = client.chat.completions.create(
2
    model="reka-flash-research",
3
    messages=[
4
        {
5
            "role": "user",
6
            "content": "What’s the weather like?",
7
        },
8
    ],
9
    extra_body={
10
        "research": {
11
            "web_search": {
12
                "user_location": {
13
                    "approximate": {
14
                        "city": "San Francisco",
15
                        "region": "CA",
16
                        "country": "US",
17
                    }
18
                },
19
            },
20
        }
21
    },   
22
)

• While only one field among city, region, country, timezone is required, it is encouraged to provide as much detail as possible to improve search relevance.