openai · OpenAI Platform Docs

Web search

Teaches how to integrate web search capabilities into AI workflows using the Responses API or Chat Completions, including selecting between non-reasoning, agentic, and deep research modes, managing domain filtering, a...

Import to Prompt Buddy

Derived skill

Files assembled from official documentation

Viewing SKILL.md

Web search

When To Use

Use when you need to implement real-time internet access, migrate existing search integrations, or configure different depths of web research ranging from quick lookups to long-running agentic investigations.

Reference Files

File	Contains	Use For
`SKILL.md`	Entry point: scope, routing table, and workflow.	Start here.
`docs/web-search-workflow-guide.md`	A guide explaining how to integrate web search tools into the Responses API or Chat Completions to enable real-time internet access and citations.	Questions about a guide explaining how to integrate web search tools into the Responses API or Chat Completions to enable real-time i...
`examples/web-search-openai-web-search-tool-call-response.json`	A JSON object representing a completed web search tool call and its corresponding assistant message output.	Exact payloads, commands, or snippets shown in A JSON object representing a completed web search tool call and its corresponding assistant message output.

What This Skill Covers

Web search allows models to access up-to-date information from the internet and provide answers with sourced citations. To enable this, use the web search to...
Main sections: Choose an integration, Output and citations, Migrating from legacy web search, Search context size, Run longer web research.

Workflow

Open the most relevant file under docs/ for the exact documented workflow and wording.
Open schemas/ files for exact structured contracts.
Open examples/ files for concrete requests, commands, snippets, and manifests.
Do not add behavior or configuration that is not present in the attached source files.

Canonical source: https://developers.openai.com/api/docs/guides/tools-web-search.md