개발자들에게 Brave 검색 API는 빅테크 기업에 종속되지 않는다 점, 그리고 스크래핑할 필요 없이 퍼스트 파티 인덱스를 통해서만 검색 결과를 제공하는 몇 안 되는 공개 검색 API로 가장 잘 알려져 있습니다. 또한, 실시간 검색 결과로 AI 모델에 근거를 제공하는 데 있어 가장 뛰어난 선택지이기도 합니다. Brave 검색 API가 훌륭한 뉴스 API라는 점은 상대적으로 덜 알려져 있습니다. 단일 REST 엔드포인트를 통해 웹 전반에서 최신의 구조화된 뉴스를 프로그래밍 방식으로 손쉽게 가져오는 방법을 제공합니다. 최신 정보를 지속적으로 반영해야 하는 뉴스 애그리게이터, 미디어 모니터링 도구 또는 AI 어시스턴트를 개발 중이라면, Brave의 뉴스 API가 도움이 될 수 있습니다.
이 글에서는 Brave 검색 API가 뉴스 API로 어떻게 작동하는지 살펴봅니다. 전용 뉴스 엔드포인트의 역할, 반환되는 데이터, 적합한 사용 사례, 그리고 첫 API 호출 방법까지 자세히 설명합니다.
뉴스 API란?
뉴스 API는 개발자가 REST 엔드포인트를 통해 뉴스 기사를 조회하여 구조화된 JSON 데이터로 가져올 수 있게 해주는 서비스입니다. 뉴스 API를 사용하면, 불안정한 맞춤형 코드로 뉴스 사이트를 긁어모으는 대신 키워드, 날짜, 출처, 언어, 국가별로 전 세계의 실시간 뉴스를 필터링할 수 있습니다.
전용 뉴스 API를 포함하는 Brave 검색 API
Brave 검색 API는 웹, 이미지, 동영상 엔드포인트와 더불어 /news/search에서 전용 뉴스 검색 API를 제공합니다. 쿼리와 몇 가지 선택적 필터를 전송하면, API가 최근 관련 뉴스 기사를 담은 클린 JSON 페이로드를 반환합니다. 각 기사에는 제목, URL, 출처, 설명, 게시일, 그리고 추가 콘텐츠 발췌문(선택 사항)이 포함됩니다.
심지어 is_news_breaking이나 is_live와 같은 속성도 포함되어 있어, 최신 속보를 효과적으로 전달하는 데 도움이 됩니다.
무엇보다도, Brave의 뉴스 API의 가장 큰 차별점은 검색 결과가 어디서 제공되는가에 있습니다. Brave는 요청 시점에 다른 검색 엔진의 결과를 수집하거나 뉴스 사이트를 긁어오는 방식 대신, 400억 개 이상의 웹페이지로 구성된 자체 독립적인 퍼스트 파티 색인을 활용합니다. 뉴스 API의 경우, 이러한 독립성은 결과의 일관성을 높여주며, 접근 권한을 변경하거나 차단할 수 있는 서드 파티에 대한 의존성이 전혀 없음을 의미합니다.
Brave의 뉴스 검색 API 작동 방식
뉴스 검색 API를 사용하려면 다음과 같이 몇 단계만 거치면 됩니다.
- 쿼리 전송: 검색어와 API 키를 포함하여
/news/search엔드포인트에 요청을 보냅니다. 쿼리에는 주제, 기업, 사건 등 최신 뉴스 소식을 확인하고 싶은 어떤 내용이든 입력할 수 있습니다. - 날짜, 국가, 언어별 필터링: 선택적 매개변수를 사용하면 최신성 범위(예: 지난 24시간 또는 지난 주), 대상 국가, 언어와 같은 정밀한 쿼리 필터링으로 검색 결과를 좁힐 수 있습니다. 이를 통해 광범위한 검색 결과를 집중적인 맞춤형 뉴스 피드로 전환할 수 있습니다.
- 구조화된 결과 반환: 엔드포인트는 구조화된 JSON 페이로드, 즉 코드가 신뢰할 수 있는 일관된 필드를 가진 기사 목록을 반환합니다. 파싱해야 할 HTML도, 관리해야 할 스크래핑 작업도 없습니다. 저장, 화면 표시, 또는 최종 사용자를 위한 답변 생성 모델 입력값으로 바로 사용할 수 있는 데이터가 저장됩니다.
- AI용 추가 스니펫 활용: 각 결과에는 여러 개의 추가 발췌문이 포함될 수 있으며, 이를 통해 모델은 기사당 두 개 이상의 구절을 바탕으로 작업을 수행할 수 있습니다. 따라서 뉴스 API는 더 풍부한 문맥을 바탕으로 우수한 답변을 도출해야 하는 요약 및 검색 증강 생성(RAG)에 매우 적합합니다.
실시간 최신성과 전 세계 보도 범위
Brave 검색 인덱스 시스템은 지속적으로 웹을 크롤링하며, 웹 디스커버리 프로젝트(WDP)를 통해 실제 사용자로부터 정기적으로 정보를 수집합니다. 이러한 인덱스 구축 메커니즘 덕분에 인덱스가 항상 최신 상태를 유지할 수 있으며, 결과적으로 Brave 검색 API는 단순한 캐시 데이터 피드가 아닌 진정한 실시간 뉴스 API로서 기능하게 됩니다. 최신성 필터를 사용하면 지난 24시간 동안의 속보를 수집하거나, 지난 일주일간의 특정 주제를 추적하거나, 게재일 기준 필터링을 위한 사용자 지정 범위를 설정할 수 있습니다. 오늘 아침의 주요 뉴스든 특정 기간의 기사든, 기간은 직접 설정하실 수 있습니다.
보도 범위는 신속할 뿐만 아니라 매우 광범위합니다. Brave의 뉴스 검색 결과는 다양한 언어로 제공되는 신뢰할 수 있는 전 세계 주요 언론 매체를 아우르며, 국가 및 언어별 타깃팅 기능이 기본으로 내장되어 있습니다. 이러한 광범위함 덕분에 Brave 뉴스 API는 현대적인 신문 API의 역할을 완벽히 수행합니다. 지역별 피드나 기존 신디케이션을 번거롭게 연결할 필요 없이, 단일 엔드포인트를 통해 전 세계 디지털 뉴스룸의 데이터를 수집할 수 있으며, 지역과 언어를 초월해 속보뿐만 아니라 연구 활동까지 뒷받침할 수 있는 방대한 아카이브를 갖추고 있습니다.
뉴스 API의 일반적인 사용 사례
Brave 뉴스 API는 다음과 같이 실무에서 활용되는 다양한 프로젝트에 적용할 수 있습니다.
- 뉴스 애그리게이터 파이프라인: 전 세계의 다양한 언어로 제공되는 보도 자료를 수집하고 타깃 독자에 맞춰 순위를 재정렬하는 뉴스 애그리게이터를 구축할 수 있습니다. Goggles를 활용하면 쿼리 시점에 신뢰할 수 있는 도메인의 순위를 높이거나 다른 도메인을 필터링할 수도 있으므로, 뉴스 애그리게이터 API의 확장을 나중에 별도로 붙이는 것이 아니라 플랫폼 자체에서 기본적으로 처리할 수 있습니다.
- 미디어 모니터링: 최신성 필터를 활용하여 다양한 매체에 걸쳐 브랜드, 인물 또는 주제를 거의 실시간으로 추적하고, 새로운 보도가 나오자마자 포착할 수 있습니다.
- 트렌드 및 시사 분석: 구조화된 기사 데이터를 분석 도구나 대시보드에 입력하여 해당 뉴스가 어떻게 전개되는지 추적합니다.
- 연구 및 아카이브: 날짜 필터링 기능을 활용하여 특정 주제에 대한 보도가 시간이 지남에 따라 어떻게 변화했는지 연구할 수 있습니다.
- AI의 근거 확보: 모델에 최신의 인용 가능한 뉴스 자료를 제공하여, 학습 데이터에만 의존하지 않고 현실 세계의 최신 정보가 반영된 답변을 생성하도록 합니다.
개인정보 보호와 독립성
개인정보 보호, 독립성, 그리고 항상 사용자를 최우선으로 하는 Brave의 브랜드 약속은 뉴스 API에도 동일하게 적용됩니다. Brave 검색 API는 스크래핑이 아닌 자체 독립형 웹 인덱스를 기반으로 결과를 제공하므로 진정한 의미의 제로 데이터 보존(ZDR)을 구현하고 더욱 철저한 규정 준수를 보장할 수 있습니다. 이는 뉴스 API가 규제 대상 제품이나 기업용 데이터 파이프라인 내에 위치해 있을 때 특히 유용하며, “독립성”이란 뉴스 피드가 써드 파티의 약관에 의존하지 않는다는 의미이기도 합니다. 최종 사용자용 Brave 검색 엔진을 구동하는 것과 동일한 인덱스가 뉴스 API의 검색 결과도 구동하기 때문입니다.
시작하기: 뉴스 API 키 및 첫 번째 요청
시작하는 데 단 몇 분밖에 걸리지 않습니다.
- 뉴스 API 키 받기: Brave 검색 API 대시보드에 가입한 후 키를 생성하세요. 모든 요금제에는 매월 5달러 상당의 무료 크레딧이 포함되어 있습니다. 유료 요금제로 전환하기 전에 충분히 프로토타입을 테스트해 볼 수 있어, 진정한 개발자용 무료 뉴스 API로 활용될 수 있습니다.
- 뉴스 검색 API 호출: 쿼리와 필터 조건을 포함하여
/news/search로 요청을 전송합니다.
예를 들어, cURL을 사용한 최소한의 요청 예시는 다음과 같습니다.
curl "https://api.search.brave.com/res/v1/news/search?q=climate+summit&freshness=pd" \
-H "Accept: application/json" \
-H "X-Subscription-Token: <YOUR_API_KEY>"Python에서 뉴스 API를 호출하는 코드 역시 마찬가지로 간결합니다. 아래 예제에서는 import requests를 사용하고, 필터를 매개변수로 전달하며, 상태 코드를 확인한 후 response.json()을 사용하여 JSON 페이로드를 파싱합니다.
import requests
url = "https://api.search.brave.com/res/v1/news/search"
params = {"q": "artificial intelligence", "freshness": "pw", "country": "us"}
headers = {
"Accept": "application/json",
"X-Subscription-Token": "<YOUR_API_KEY>",
}
response = requests.get(url, params=params, headers=headers)
print(response.status_code) # 200 on success
data = response.json() # structured JSON payload
for article in data["results"]:
print(article["title"], article["url"])여기에서 쿼리 필터링(최신성, 국가, 언어)을 조정하고, 더 풍부한 맥락을 파악하기 위해 추가 스니펫을 요청하며, Goggles를 통해 검색 결과를 재정렬할 수 있습니다. 또한 Brave의 독립형 인덱스에 있는 동일한 저지연 REST 엔드포인트를 통해 이 모든 작업을 수행할 수 있습니다.
Brave 검색 API가 뉴스 API로 최적인 이유
Brave 검색 API는 단순한 웹 검색 도구를 넘어, 독립형 인덱스 시스템을 기반으로 구축된 실시간, 글로벌, 개인정보 보호형 뉴스 API입니다. AI에 바로 적용할 수 있는 구조화된 데이터를 제공하고, 다양한 언어로 전 세계 주요 언론사를 폭넓게 다룹니다. 날짜, 국가, 언어별 정밀 필터링을 지원하며, 신뢰할 수 있는 퍼스트 파티 출처를 기반으로 합니다. 스크래핑을 하거나 써드 파티에게 통제권을 넘기지 않으면서 최신 뉴스 데이터를 확보하고자 하는 팀에게 Brave 검색 API는 최적의 뉴스 API입니다.
개발을 시작할 준비가 되셨나요? Brave 검색 API를 둘러보고, 매월 제공되는 무료 크레딧으로 뉴스 엔드포인트를 사용해 보세요.
자주 묻는 질문
Brave에서 무료 뉴스 API를 제공하나요?
어느 정도는 그렇습니다. Brave 검색 API의 모든 요금제에는 매월 5달러 상당의 무료 크레딧이 포함되어 있습니다. 사용 한도를 직접 설정할 수 있어서 매달 제공되는 5달러 무료 크레딧을 초과하지 않도록 관리할 수 있습니다. 덕분에 뉴스 API는 비용 부담 없이 프로토타입을 만들고자 하는 개발자들에게 사실상 무료 뉴스 API로 활용될 수 있습니다.
Brave의 뉴스 API는 실시간인가요?
예. Brave 검색은 웹을 지속적으로 크롤링하고 웹 디스커버리 프로젝트를 통해 실제 브라우저 사용자들로부터 익명의 데이터를 기여받기 때문에, Brave 검색 뉴스 API는 실시간 뉴스 API로 작동하여 온라인에 최신 사건이 등록된 지 단 몇 분 만에 업데이트되는 경우가 많습니다. Brave 검색 API의 최신성 필터를 사용하면 최근 24시간, 지난 1주일 또는 원하는 특정 날짜 범위의 보도 자료를 추출할 수 있습니다.
Brave 검색 뉴스 API를 활용하여 뉴스 애그리게이터를 구축하려면 어떻게 해야 하나요?
Brave 검색 뉴스 API를 사용하여 뉴스 애그리게이터를 구축하려면, /news/search에 국가 및 언어 필터를 적용해 광범위한 뉴스를 검색한 후, Goggles를 사용하여 선호하는 웹사이트를 기준으로 검색 결과를 재정렬하면 됩니다.
Brave를 신문 API로 활용할 수 있을까요?
예. 전 세계 언론 매체의 보도를 수집하고 날짜 필터링 기능을 통해 과거 기사까지 찾아볼 수 있는 Brave 검색 API는 최신 속보는 물론 과거 데이터 연구를 위한 신문 API로도 손색없이 활용할 수 있습니다.
파이썬으로 뉴스 API를 사용할 수 있나요?
예. 이 페이지 앞부분에 소개된 뉴스 API 파이썬 예제에서 볼 수 있듯이, requests 모듈을 사용한 몇 줄의 코드만으로도 엔드포인트를 조회하고 JSON 페이로드를 파싱할 수 있습니다.
공식적인 Google 뉴스 API가 있나요?
아니요. 구글은 공식적인 구글 뉴스 API를 제공하지 않기 때문에, 개발자들은 종종 구글 뉴스 데이터를 얻기 위해 써드 파티 도구나 스크래퍼 기반 API를 이용합니다. Brave 검색 API는 자체 인덱스에서 직접 뉴스를 제공하는 퍼스트 파티 대안입니다.
검색 API는 어떻게 AI에 시사 문제에 대한 맥락을 제공하나요?
AI 모델은 특정 시점까지만 학습되기 때문에, 모델 단독으로는 최신 시사 이슈에 대해 정확하고 신뢰할 수 있는 답변을 내놓기 어렵습니다. 검색 API는 이러한 한계를 극복합니다. 쿼리 시점에 최신의 구조화된 뉴스 데이터를 가져옴으로써, AI 모델에 최신 맥락을 제공합니다. 덕분에 AI의 답변은 학습 당시의 정보에만 머물지 않고 ‘지금 무슨 일이 일어나고 있는지’를 정확히 반영할 수 있게 됩니다. 이것이 바로 Brave 검색 API와 같은 뉴스 API가 ‘그라운딩’ 및 ‘검색 증강 생성(RAG)’ 기술의 자연스러운 기반이 되는 이유입니다.
