서론: 공식 출처 기반 리서치를 API에 붙이기
광고 리서치는 최신 정보와 출처 확인이 함께 필요합니다. OpenAI 문서 기준으로 Web search는 모델이 답변을 만들기 전 웹에서 최신 정보를 검색하고, 출처 인용이 포함된 답변을 제공하도록 하는 도구입니다. 2026년 기준으로 이 글은 OpenAI 공식 문서와 가격 페이지에 명시된 항목만 사용해, 마케터와 개발자가 광고 리서치 워크플로우에 Web Search를 설정하는 방법을 정리합니다.
도구 소개: Responses API + Web Search
OpenAI의 Responses API는 텍스트·이미지 입력과 텍스트 출력을 지원하며, built-in tools로 web search, file search, computer use 등을 사용할 수 있습니다. Web search를 사용한 응답에는 web_search_call 출력 항목과, 인용 URL이 포함된 message 출력 항목이 포함됩니다. OpenAI 문서는 웹 결과를 최종 사용자에게 표시할 때 인라인 인용을 명확하고 클릭 가능하게 보여야 한다고 안내합니다.
가격·스펙 비교 표
| 항목 | 공식 페이지 기준 내용 |
|---|---|
| GPT-5.5 | 입력 $5.00 / 1M tokens, 캐시 입력 $0.50 / 1M tokens, 출력 $30.00 / 1M tokens |
| GPT-5.4 mini | 입력 $0.75 / 1M tokens, 캐시 입력 $0.075 / 1M tokens, 출력 $4.50 / 1M tokens |
| Web search | $10.00 / 1k calls, Search content tokens are free |
| GPT-image-2 | 이미지 입력 $8.00 / 1M tokens, 캐시 입력 $2.00 / 1M tokens, 이미지 출력 $30.00 / 1M tokens |
설치·설정 방법
- OpenAI 플랫폼에서 API 키를 준비합니다.
- 서버 환경 변수에
OPENAI_API_KEY를 설정합니다. - Responses API 요청에
tools: [{ "type": "web_search" }]를 추가합니다. - 필요한 경우
include: ["web_search_call.action.sources"]를 사용해 검색에 참고된 URL 목록을 확인합니다. - 특정 공식 도메인만 확인해야 할 때는
filters.allowed_domains에 허용 도메인을 넣습니다. OpenAI 문서는 최대 100개 URL allow-list를 지원한다고 설명합니다.
사용법 예시: 광고 리서치 요청
import OpenAI from "openai";
const client = new OpenAI();
const response = await client.responses.create({
model: "gpt-5",
tools: [{
type: "web_search",
filters: {
allowed_domains: ["business.google.com", "business.facebook.com"]
}
}],
include: ["web_search_call.action.sources"],
input: "2026년 4월 기준 광고 제품 업데이트를 출처와 함께 요약해줘."
});
console.log(response.output_text);
마케팅팀에서는 위 구조를 활용해 광고 플랫폼 업데이트, 캠페인 참고 자료, 경쟁사 공개 발표 요약을 요청할 수 있습니다. 단, 출력 결과를 광고 문구로 바로 쓰기보다 출처 URL을 열어 정책·날짜·가격을 확인하는 검수 단계를 포함해야 합니다.
장단점과 운영 체크리스트
장점
- 최신 정보 검색과 출처 인용을 API 요청 안에서 함께 처리할 수 있습니다.
allowed_domains로 공식 사이트 중심 검색을 설정할 수 있습니다.sources필드로 검색 중 참고된 URL 목록을 확인할 수 있습니다.
단점·제한
- Web search tool call 비용이 별도로 발생합니다.
- OpenAI 문서 기준 Web search는
gpt-5의minimalreasoning과gpt-4.1-nano에서 지원되지 않습니다. - Web search는 128000 컨텍스트 윈도우로 제한된다고 문서에 명시되어 있습니다.
체크리스트
- 공식 도메인 allow-list를 먼저 정한다.
- 응답 UI에 인라인 인용을 클릭 가능하게 표시한다.
- 가격·정책·날짜는 원문 링크에서 재확인한다.
- 광고 소재 반영 전 사람이 최종 검수한다.
결론
OpenAI Web Search는 2026년 기준 광고 리서치 자동화에 붙일 수 있는 API 도구입니다. 핵심은 검색 자체보다 공식 도메인 제한, 출처 표시, 검수 절차를 함께 설계하는 것입니다. 폴라애드는 광고 운영과 AI 워크플로우를 함께 다루는 팀을 위해 API 기반 리서치 자동화 구조 설계를 도와드립니다. AI 기반 광고 리서치와 운영 자동화가 필요하다면 Meta 광고 전문 폴라애드에 문의해 주세요.
