TL;DR

  • Cloudflare가 AI 에이전트와 애플리케이션이 인터넷을 검색하고 최신 정보에 근거해 응답하도록 지원하는 Web Search API 베타를 출시함.
  • 출시 시점에 선택 가능한 검색 제공업체는 Ceramic.ai, Exa, Linkup 세 곳임.
  • 세 제공업체 모두 Cloudflare를 통한 요청에 Zero Data Retention을 지원하고 Cloudflare의 검증된 봇 크롤링 표준을 준수하기로 약속함.
  • AI Gateway를 통해 검색 요청이 게이트웨이 로그에 표시되고, 제공업체의 공개 API 가격으로 AI Gateway 크레딧에서 청구되며 추가 할증은 없음.
  • REST API 또는 Worker의 AI 바인딩으로 호출할 수 있고, 자체 제공업체 API 키도 사용할 수 있음.

Web Search API 소개

  • 2026년 10월 2일 기준으로 Web Search API 베타를 이용할 수 있음.
  • AI 에이전트와 애플리케이션이 URL을 추측하거나 모델의 학습 데이터 기준 시점에 의존하는 대신, 인터넷을 검색하고 실시간 정보에 근거해 응답하도록 지원함.

검색 제공업체와 데이터 처리

  • 출시 시점에 Ceramic.ai, Exa, Linkup 중에서 검색 제공업체를 선택할 수 있음.
  • 세 제공업체 모두 Cloudflare를 통해 처리되는 요청에 대해 Zero Data Retention을 지원함.
  • 세 제공업체 모두 Cloudflare의 검증된 봇 크롤링 표준을 준수하기로 약속함.

AI Gateway를 통한 요청과 요금

  • Web Search API는 AI Gateway를 통해 실행되며 검색 요청은 게이트웨이 로그에 표시됨.
  • 요금은 각 제공업체의 공개 API 가격에 따라 AI Gateway 크레딧에서 청구되며 추가 할증은 없음.
  • 자체 제공업체 API 키를 사용할 수도 있음.

API 호출 방식

  • REST API 요청에는 검색어, 제공업체, 결과 수 제한, 게이트웨이 ID를 지정함. 예시에서는 Salt Lake City의 가을철 즐길 거리를 검색하고, ceramic 제공업체와 결과 5개, default 게이트웨이를 설정함.
  • Worker에서는 AI 바인딩의 env.AI.websearch를 호출해 게이트웨이 ID, 검색어, 제공업체, 결과 수 제한을 지정하고 응답을 JSON으로 읽음. 예시 제공업체는 exa임.
  • 시작 방법은 ‘Web Search API 사용 방법’ 문서를 참조함.