DeepSeek가 2026년 10월 17일 개발자용 Search·Fetch API를 공개했습니다. 에이전트나 검색증강생성(RAG) 앱에서 실시간 웹 정보를 활용할 수 있도록, Search는 DeepSeek 자체 검색엔진으로 웹페이지를 찾고 Fetch는 지정한 페이지를 가져옵니다. 각 엔드포인트의 요금은 성공한 요청 1,000건당 0.75달러입니다.
14
23
24
엔드포인트와 인증
두 API는 https://api.deepseek.com을 기본 주소로 사용하며, 응답 형식은 JSON입니다. DeepSeek API와 같은 Bearer 인증 방식을 씁니다.
23
- Search:
POST https://api.deepseek.com/v1/tools/search
- Fetch:
POST https://api.deepseek.com/v1/tools/fetch
Search는 검색어에 맞는 웹페이지를 찾아 구조화된 결과를 반환하고, Fetch는 지정한 URL의 페이지 한 개를 가져와 제목과 본문을 Markdown으로 제공합니다.
17
18
23
Search: 검색어, 결과 수와 필터
필수 항목인 query에는 공백만 있는 문자열이 아닌 1128자의 검색어를 넣어야 합니다. count로 결과 수를 지정할 수 있으며, 기본값은 10개, 허용 범위는 150개입니다.
17
선택 입력값으로는 원래 질문을 전달하는 ori_question, 지역 설정에 쓰이는 localization, 전체 본문을 포함할지 지정하는 need_content가 안내돼 있습니다. 한 연동 문서에서는 need_content의 기본값을 false로 제시하지만, 선택 항목마다 정확히 어떤 형식과 의미를 갖는지는 제공된 문서 발췌만으로 모두 확인하기 어렵습니다.
17
36
공식 API 문서는 특정 도메인을 지정하는 site:, 도메인을 제외하는 -site:, 정확한 구문을 찾는 따옴표 검색을 지원한다고 안내합니다. 별도의 연동 문서에는 -term, lang:, after:, before:도 나옵니다. 다만 추가 연산자는 공식 API 문서에서 확인된 범위와 구분해 참고하는 편이 안전합니다.
17
34
검색 결과는 순위가 매겨진 구조화된 목록입니다. 연동 문서에는 제목과 URL 외에 snippet, summary, 요청 시 포함될 수 있는 content, 날짜, rerank_score, authority 등이 기재돼 있습니다. 이 문서는 스니펫을 보통 100200자, 요약을 600800자로 설명합니다. 다만 필드 구성과 길이는 API 참조 문서가 아닌 연동 문서에 나온 정보이므로, 구현 전에 현재 응답 스키마를 확인해야 합니다.
36
Fetch: URL을 Markdown으로
Fetch는 최대 8,192자의 URL을 받습니다. API 문서에 따르면 URL은 호스트가 포함된 HTTP 또는 HTTPS 주소여야 하며, 사용자 이름이나 비밀번호를 포함할 수 없습니다. 응답에는 페이지 제목과 Markdown 형식의 본문이 담깁니다.
18
모든 사이트에 접근할 수 있는지, 페이지 내용을 어떤 조건에서 추출하지 못하는지에 대한 보편적인 보장은 제공된 문서에서 확인되지 않습니다. 따라서 어떤 URL이든 본문 전체를 가져올 수 있다고 전제해서는 안 됩니다.
18
요금과 한시적 무료 적용
Search와 Fetch는 각각 성공한 요청 1,000건당 0.75달러입니다. 보도와 연동 자료는 실패한 요청, 빈 결과, 시간 초과는 과금하지 않는다고 설명합니다. 검색·가져오기 요금은 모델 토큰 사용료와 별도이므로, 가져온 내용을 모델이 처리하는 데 드는 비용까지 포함한다고 보면 안 됩니다.
2
13
24
DeepSeek는 DeepSeek Harness, Claude Code, Codex의 서버 측 도구를 통한 Search·Fetch 호출을 DeepSeek API 사용자에게 한시적으로 무료 제공한다고 밝혔습니다. 과금은 2026년 10월 31일 16:00 UTC, 즉 베이징 시간으로 11월 1일 00:00부터 시작될 예정입니다. 이 혜택은 해당 도구 연동에 대한 것으로, 직접 호출하는 API까지 일괄 무료라는 뜻은 아닙니다.
2
24
요청 제한과 확인이 필요한 부분
2차 보도에서는 Search·Fetch API에 계정당 초당 5회 요청 제한이 있다고 전합니다.
4
10 다만 제공된 공식 문서 발췌만으로는 두 엔드포인트의 제한이 각각 따로 적용되는지, 계정과 API 키 중 무엇을 기준으로 제한하는지, Fetch에 도메인별 추가 제한이 있는지, 제한 초과 시 어떤 응답을 받는지까지 확인할 수 없습니다.
17
18
DeepSeek의 별도 제한 문서는 모델별 동시 처리 한도를 설명하지만, 해당 한도와 Search·Fetch 요청 제한의 관계는 명시하지 않습니다. Search·Fetch 제한을 넘겼을 때 항상 HTTP 429 응답이 오는지도 확인되지 않았습니다.
25
정리하면, 이번 공개로 자체 검색엔진을 사용하는 Search와 페이지 내용을 가져오는 Fetch의 기본 인터페이스, 그리고 요청 단위 요금이 제시됐습니다. 선택 입력값의 세부 형식이나 전체 응답 스키마, 예외 상황을 구현에 반영할 때는 연동 자료만으로 단정하지 말고 최신 API 문서를 확인하는 것이 좋습니다.
17
18
23