DeepSeek이 검색·수집 API를 성공 요청 1000건당 0.75달러에 공개

Hacker News14일 전조회 2

DeepSeek이 자체 구축한 검색 엔진을 기반으로 한 Search API와 Fetch API를 공개했다. 에이전트와 RAG 애플리케이션이 실시간 웹 콘텐츠에 접근하도록 돕는 것이 목적이며, 두 API 모두 기존 DeepSeek API와 동일한 베어러 토큰 인증을 쓰는 순수 JSON 인터페이스다. 별도 SDK 없이 HTTP 요청만으로 호출할 수 있다.

엔드포인트는 두 개다. 검색은 `POST https://api.deepseek.com/v1/tools/search`, 페이지 수집은 `POST https://api.deepseek.com/v1/tools/fetch`이며 베이스 URL은 `https://api.deepseek.com`으로 같다. 요청 헤더에는 인증 토큰과 `application/json` 콘텐츠 타입을 넣으면 된다.

검색 요청에는 질의어(`query`, 1~128자)가 필수이고, 결과 개수(`count`)는 1~50 범위에서 지정하며 기본값은 10이다. 사용자의 원래 질문을 함께 넘겨 질의 해석을 보정하는 `ori_question`, 결과를 지역화할 IP를 지정하는 `localization`, 본문까지 받을지 정하는 `need_content`도 선택 항목으로 있다. 질의어에는 `site:`와 `-site:`, 특정 단어·구문 제외를 뜻하는 `-` 연산자, 정확한 구문을 찾는 따옴표, 언어 코드를 지정하는 `lang:`, 날짜 범위를 자르는 `after:`·`before:` 같은 연산자를 조합해 쓸 수 있다.

응답의 `results` 배열은 단순 링크 목록이 아니다. 관련성·권위·최신성을 합산한 0~3점 척도의 `rerank_score`(1.5 이상이면 고품질로 간주), UI 노출용 100~200자 `snippet`, 모델이 읽도록 만든 600~800자 `summary`, 페이지 본문, 사이트 이름과 아이콘, 발행 시각, 0~4등급의 `authority`(3 이상은 권위 있는 출처, -1은 미상)가 함께 온다. 검색 결과가 없으면 빈 배열이 돌아온다.

Fetch는 URL 하나를 받아 페이지를 마크다운 텍스트로 돌려준다. URL은 8192자를 넘을 수 없고 사용자 이름이나 비밀번호가 포함된 HTTP·HTTPS 주소는 거부된다. 응답은 제목과 마크다운 본문 두 필드로 단순하다.

과금 방식이 눈에 띈다. 토큰이나 반환된 결과 수가 아니라 성공한 요청 단위로 매기며, Search와 Fetch 모두 1000건당 0.75달러다. HTTP 200을 받고 실제 결과를 얻은 경우에만 청구된다. 검색이 빈 배열을 돌려주거나, 실패하거나, 타임아웃이 나면 비용이 붙지 않는다. `count`를 늘려도 건당 가격은 그대로라는 점도 명시돼 있다.

배경에는 에이전트 워크플로의 확산이 있다. 최근 코딩 에이전트와 RAG 서비스는 최신 문서를 검색하고 페이지를 읽어 오는 과정을 필수로 요구하지만, 이를 위해 자체 크롤러와 검색 인덱스를 운영하는 비용은 작지 않다. DeepSeek은 자사 검색 엔진을 그대로 API로 노출해 이 부분을 흡수하려는 것으로 읽힌다.

실무에서는 검색 결과의 요약과 본문을 한 번의 호출로 받을 수 있어, 검색 후 개별 페이지를 다시 긁는 2단계 파이프라인을 단순화할 수 있다. `rerank_score`와 `authority`가 응답에 포함되므로 별도 재정렬 모델 없이 임계값으로 결과를 걸러내는 구성도 가능하다.

주의할 점도 분명하다. Fetch는 대상 사이트의 가용성과 접근 정책을 그대로 따르며, 사이트 정책 차단이나 지원하지 않는 콘텐츠 타입, 추출 가능한 마크다운이 없는 페이지는 404로 떨어진다. 403은 보안 정책이 요청을 거부한 경우다. 408·429·5xx는 기다렸다 재시도하면 되지만, 402는 잔액을 채워야 하고 나머지 4xx는 요청을 고치지 않은 채 재시도해서는 안 된다. 오류 형식은 OpenAI 호환 스키마를 따르며 `param` 필드는 항상 null이다. 또한 DeepSeek Harness나 Claude Code, Codex를 통해 DeepSeek API를 쓰는 경우 서버 측 도구 호출이 이미 이 API들을 거치는데, 이런 호출은 현재 무료이며 베이징 시간 자정부터 건당 과금이 시작된다.