Web Search

gllm-inference | Tutorial: Web Search | API Reference

Supported by: OpenAILMInvoker, XAILMInvoker

What is Web Search

Web search is a native tool that allows the language model to search the web for relevant information. When it's enabled, web search citations are stored in the outputs attribute of the LMOutput object and can be accessed via the citations property.

Web search can be enabled either as a string, an enum, or a native tool object:

import asyncio
from gllm_inference.lm_invoker import OpenAILMInvoker
from gllm_inference.model import OpenAILM
from gllm_inference.schema import NativeTool, NativeToolType

# Option 1: as string
web_search_tool = "web_search"
# Option 2: as enum
web_search_tool = NativeToolType.WEB_SEARCH
# Option 3: as native tool object (useful for providing custom kwargs)
web_search_tool = NativeTool.web_search(**kwargs)

lm_invoker = OpenAILMInvoker(OpenAILM.GPT_5_NANO, tools=[web_search_tool])

Let's try it to use it to find information about a movie that came out after the LM's cutoff date!

query = "How much did `Zootopia 2` make in the box office?"
response = asyncio.run(lm_invoker.invoke(query))

print(f"=== Response ===\n{response.text}\n")

for citation in response.citations:
    print(f"=== Citation ===\n{citation}\n")

Output:

=== Response ===
As of January 7, 2026, Zootopia 2 has grossed about $1.588 billion worldwide. Breakdown:
- Domestic (U.S. & Canada): approximately $363.65 million
- International: approximately $1.2246 billion

Source: Box Office Mojo. ([boxofficemojo.com](https://www.boxofficemojo.com/release/rl687767553/?utm_source=openai))

=== Citation ===
id='4397687f-b040-47cd-842e-30a1bc249ae2' 
content='url_citation' 
metadata={
    'type': 'url_citation', 
    'title': 'Zootopia 2 - Box Office Mojo', 
    'url': 'https://www.boxofficemojo.com/release/rl687767553/?utm_source=openai',
    'start_index': 220, 
    'end_index': 311, 
} 
score=None