DeepSeek의 검색 API와 가져오기 API는 한 쌍의 도구입니다. 검색 API는 키워드로 웹페이지를 찾아 제목, 링크, 요약, 날짜, 품질 점수를 반환하고, 가져오기 API는 개별 웹페이지를 가져와 모델이나 검색 흐름용으로 Markdown으로 변환합니다. 두 인터페이스 모두 DeepSeek 채팅 API와 같은 키를 사용하며, 채팅 모델을 거치지 않고 원시 JSON 요청으로 동작합니다. 과금은 성공한 요청 건별로 이루어지며, 성공한 요청 1,000건당 0.75달러이고 검색과 가져오기는 따로 집계됩니다.
표준 흐름: 먼저 검색하고, 다음에 가져오기
먼저 검색 엔드포인트를 호출하세요. 쿼리 필드는 1~128자이며 site:, -site:, 따옴표 구문, 언어, 날짜 등의 연산자를 지원합니다. 짧은 키워드는 쿼리에 쓰고 사용자의 전체 질문은 ori_question 필드에 넣되, 이 필드도 128자로 제한됩니다. 둘째, 반환된 결과 배열에서 품질이 높은 항목을 고르세요. rerank_score는 만점이 3점이며 1.5점 이상이면 고품질, authority는 만점이 4점이며 3점 이상이면 고권위로 취급됩니다. 셋째, 고른 페이지에 대해 가져오기 엔드포인트를 호출하고 URL 하나를 전달해 제목과 Markdown 본문을 받으세요. 검색에서 need_content를 켜면 내용을 바로 받아 호출을 한 번 아낄 수 있습니다. 가져오기는 대상 사이트의 접근 정책에 따릅니다. 페이지를 가져올 수 없으면 같은 주소를 반복 시도하기보다 먼저 출처를 바꾸세요.
속도 제한과 오류 처리
계정마다 검색과 가져오기는 각각 5 QPS로 제한되며, 초과하면 429가 반환됩니다. 408, 429, 5xx 오류가 발생하면 잠시 기다렸다가 다시 시도하고, 402 오류가 발생하면 먼저 충전하고, 그 밖의 4xx 오류는 그대로 다시 시도하지 말고 먼저 요청을 수정하세요. 결과가 없거나 실패한 요청은 과금되지 않으며, 결과를 성공적으로 반환한 요청만 과금됩니다. 2026년 11월 1일 베이징 시간 0시부터 DeepSeek Harness, Claude Code, Codex를 통한 서버 측 도구 호출도 건별로 과금됩니다. 이전 무료 기간은 끝났으므로 호출량이 많은 흐름은 먼저 콘솔에서 사용량을 확인하세요.
이 API 쌍이 맞지 않을 때
실시간 웹 사실 없이 모델 답변만 필요할 때는 채팅 모델을 직접 호출하는 편이 더 저렴합니다. 고정된 한 페이지의 내용만 필요하고 페이지 구조가 안정적이라면 직접 내려받아 Markdown으로 변환해도 되며, 가져올 때마다 비용을 낼 필요가 없습니다. 이 API 쌍이 실제로 수고를 덜어주는 곳은 에이전트와 검색 애플리케이션이 “먼저 찾고, 다음에 읽고, 인용하는” 전체 흐름을 필요로 할 때입니다.
