AI 초보자 QnA
질문
OpenAI API 웹 검색을 한국 지역 기준으로 할 수 있나요?
답변
네. Responses API의
web_search
도구 안에
user_location
을 넣어 한국의 대략적인 지역을 검색에 참고하도록 지정합니다. 국가에는
country="KR"
를 쓰고 필요하면 도시도 추가하세요.
이 글은 이미 웹 검색을 연결한 API 요청에 지역 조건을 더하는 방법입니다. 휴대전화 GPS 권한을 켜거나 한국 사이트만 허용하는 설정과는 다릅니다. 지역을 지정해도 모든 결과가 한국 자료이거나 정확한 주변 장소라는 보장은 없습니다.
짧게 답하면
검색 지원 확인 → 도구 안에 지역 지정 → 실제 검색 호출 확인 → 출처의 지역 대조 순서로 진행하세요. 처음에는 국가만 넣고 필요한 경우에만 도시를 더합니다.
user_location
웹 검색이 참고할 대략적인 지역입니다. 기기의 정확한 좌표를 읽는 권한이 아닙니다.
country
두 글자 ISO 국가 코드를 넣습니다. 한국 기준 예시는
KR
입니다.
city·region
도시·지역 이름을 적는 자유 형식 문자열입니다. 필요한 범위만 보내세요.
처음 쓰는 사람 기준으로 설명하면
예를 들어 지역 도서관의 공개 안내를 찾는데 다른 나라 자료가 섞인다고 해 보세요. 질문에도 대상 국가를 적고 웹 검색 도구에 지역 정보를 전달하면 검색이 그 지역을 참고하도록 돕습니다. 언어를 한국어로 요청하는 일과 지역 조건을 넣는 일은 나눠서 봅니다.
Web search 가이드는 국가·도시·지역·시간대로 대략적인 위치를 지정한다고 설명합니다. Responses 참조의 위치는
tools
배열에 둔
web_search
객체 안입니다. 국가에는 두 글자 코드, 도시와 지역에는 문자열을 씁니다. 시간대를 추가한다면
Asia/Seoul
같은 IANA 이름을 사용하세요.
현재 API 참조는
user_location
을 생략하거나
null
로 보내면 미국을 기본 지역으로 쓴다고 안내합니다. 그 기본값만 피하고 특정 지역을 정하지 않으려면 위치 항목 없이
{"type":"approximate"}
를 전달합니다. 한국 검색 목적이라면 국가 정보를 명시하세요.
한 줄 정리: user_location은 검색에 참고할 지역입니다. 검색 대상 도메인을 제한하거나 결과의 사실성을 보증하는 장치로 보지 마세요.
바로 따라 해보기
1단계. 공개 질문과 지역 범위를 정합니다.
이미 동작하는 Responses 웹 검색 요청에서 모델의 지원을 확인하세요. 한국의 공개 도서관 안내처럼 민감하지 않은 질문을 고릅니다. 비교할 모델·질문과 다른 도구 설정은 그대로 유지합니다.
2단계. 웹 검색 도구에 위치를 넣습니다.
tools=[{"type":
처럼 전달합니다. 도시가 필요하면 user_location 안에
city="Seoul"
을 추가하세요. 최상위 요청이나 input 문장에 JSON을 붙이는 것으로 대신하지 않습니다.
3단계. 실제 검색과 원문을 확인합니다.
완료 응답의
output
에서
web_search_call
과 action을 확인하세요. 도구를 등록해도 모델이 검색하지 않을 수 있습니다. 검색한 답변의 인용을 열어 기관·적용 지역·날짜를 대조하고, 검색이 없었다면 지역 효과를 확인했다고 기록하지 않습니다.
주의할 점
공식 가이드는 웹 검색을 쓰는 deep research 모델에서 사용자 위치를 지원하지 않는다고 명시합니다. 지금 사용하는 모델의 검색·위치 지원을 먼저 확인하세요. 도시 이름을 넣어도 정확한 거리나 현재 영업 상태까지 확정되는 것은 아닙니다.
country에 한국어 국가명이나 전체 주소를 넣습니다. 두 글자 국가 코드와 도시 문자열을 구분하고 집·직장 주소, 좌표 등 불필요한 개인정보는 보내지 마세요.
지역을 한국으로 정했으니 한국 도메인만 나온다고 생각합니다. 위치 참고와 allowed_domains의 검색 도메인 제한은 역할이 다릅니다.
위치 설정을 바꾼 뒤 답변에 한국 지명이 나왔다는 이유만으로 검색 성공을 판단합니다. 실제 호출과 인용 원문을 확인하고 앱에 표시할 인용은 클릭할 수 있게 유지하세요.
웹사이트와 앱 중 무엇부터 쓰면 좋을까요?
설정 확인은 공식 웹 문서에서
Web search의 User location과 Responses 참조의 WebSearch 객체를 함께 읽으세요. ChatGPT 웹사이트의 설정 메뉴를 바꿔 API 요청을 조절하는 작업은 아닙니다.
비교는 API 앱·개발 환경에서
기존 요청에 국가만 추가해 결과를 읽고 필요하면 도시를 더합니다. 휴대전화에서도 같은 API 설정을 쓰지만 기기 위치 권한과는 별개입니다. API 키와 민감한 입력은 공개 로그에 남기지 마세요.
확인한 공식 자료
OpenAI 공식 가이드 — Web search — User location의 입력 형식, deep research 제한과 검색 호출·인용 표시 기준을 확인했습니다.
OpenAI API 참조 — Create a model response — WebSearch 안의 user_location 위치, 생략·null의 미국 기본값과 지역 지정 방식을 확인했습니다.
OpenAI 공식 가이드 — Using tools — tools에 기능을 연결하는 방식과 도구 등록이 실제 사용을 보장하지 않는다는 점을 확인했습니다.
자료 확인일: 2026년 10월 13일. 설정과 점검 순서는 공식 문서를 바탕으로 안내하며, 실제 위치 정확도나 검색 성능을 측정한 결과는 아닙니다.
감자나라 AI 강의보기 5,000 
