DeepSeek Search & Fetch API 가격 및 기능 개요

DeepSeek Search & Fetch API는 성공 호출 1,000회당 $0.75로 LLM 에이전트에게 저렴한 실시간 웹 접근을 제공합니다

DeepSeek는 언어 모델 에이전트가 실시간 웹 결과와 페이지 콘텐츠를 검색할 수 있도록 하는 두 개의 새로운 raw-JSON 엔드포인트인 Search와 Fetch를 발표했습니다. 두 API 모두 반환된 결과 수와 관계없이 성공적인 요청당 $0.75/1,000회로 청구됩니다.

Search API는 쿼리에 대한 구조화된 결과를 제공합니다

핵심 요점: Search 엔드포인트는 제목, URL, 스니펫, 요약 및 선택적 전체 페이지 콘텐츠가 포함된 최대 50개의 순위가 매겨진 결과를 반환합니다.

  • 엔드포인트: POST https://api.deepseek.com/v1/tools/search
  • 인증: Authorization 헤더의 Bearer 토큰; Content-Type: application/json 필수.
  • 요청 필드 (모두 JSON):
    • query (문자열, 1-128자, 필수)
    • count (정수, 기본 10, 1-50)
    • ori_question (문자열, 선택, 최대 128자)
    • localization (문자열, 선택 IP 주소)
    • need_content (부울, 기본 false) – true인 경우 응답에 페이지의 전체 Markdown 콘텐츠가 포함됩니다.
  • 지원되는 쿼리 연산자에는 site:, -site:, -, -"...", "...", lang:, after:, before:가 포함됩니다. 연산자는 단일 쿼리에서 결합할 수 있습니다.
  • 응답 스키마 (200 OK):
    {
  "results": [
    {
      "rerank_score": 2.4,
      "title": "DeepSeek V4 model released",
      "url": "https://example.com/deepseek-v4",
      "snippet": "...",
      "summary": "...",
      "content": "...",   // need_content=true인 경우에만 존재
      "site_name": "Example News",
      "site_icon": "https://example.com/favicon.ico",
      "date": "2026-06-01T00:00:00+00:00",
      "authority": 3
    }
  ]
}
  • 점수: rerank_score 범위는 0-3; 점수 ≥ 1.5는 고품질 결과를 나타냅니다. authority 3-4는 매우 권위 있는 소스를 나타냅니다.
  • 청구 규칙: HTTP 200을 반환 하고 results 배열이 비어 있지 않은 경우에만 요청이 청구됩니다.
  • 비율 제한: 계정당 5 QPS (Fetch와 독립적). 제한을 초과하면 HTTP 429가 반환됩니다.

Fetch API는 페이지의 Markdown 콘텐츠를 반환합니다

핵심 요점: Fetch 엔드포인트는 단일 URL을 가져와 제목과 전체 Markdown 본문을 반환하며, 성공적인 호출 1,000회당 $0.75로 청구됩니다.

  • 엔드포인트: POST https://api.deepseek.com/v1/tools/fetch
  • 인증: Search와 동일한 Bearer 토큰 체계.
  • 요청 필드: url (문자열, 필수, 최대 8192자, 자격 증명이 없는 유효한 HTTP/HTTPS URL이어야 함).
  • 응답 스키마 (200 OK):
    {
  "title": "Example article",
  "content": "# Example article\n\nArticle content."
}
  • 청구 규칙: HTTP 200을 반환 하고 content 필드가 비어 있지 않은 경우에만 요청이 청구됩니다.
  • 비율 제한: 계정당 5 QPS + 도메인별 추가 QPS 제한; 위반 시 HTTP 429가 반환됩니다.

오류 처리는 OpenAI 호환 형식을 따릅니다

핵심 요점: 오류는 error.message, error.type, error.code가 포함된 JSON 객체를 반환하며, param 필드는 항상 null입니다.

HTTP 상태 일반적인 원인
400 잘못된 JSON 또는 필드 값 (예: count 범위 초과)
401 API 키 누락 또는 잘못됨
402 계정 잔액 부족
403 대상 사이트 보안 정책에 의해 Fetch 차단됨
404 URL을 사용할 수 없거나, 차단되었거나, 추출할 수 없는 콘텐츠
408 요청 본문 읽기 시간 초과
413 요청 본문이 너무 큼
429 QPS 제한 초과
500 내부 서버 오류
504 다운스트림 시간 초과

재시도 지침: 408, 429 또는 모든 5xx 오류에 대해 대기 후 재시도하십시오. 요청을 수정하지 않고 다른 4xx 오류를 재시도하지 마십시오.

가격 및 제한에 대한 커뮤니티 관점

핵심 요점: 사용자들은 DeepSeek의 $0.75/1k 가격을 경쟁사와 비교하여 긍정적으로 평가하지만, 비율 제한 및 안티봇 견고성에 대한 우려를 제기합니다.

  • 가격 비교: Brave Search API는 $5/1k, Kagi는 $12/1k, Exa는 $4/1k인 반면, DeepSeek의 $0.75/1k는 상당히 저렴합니다.
  • 비율 제한 비판: 여러 댓글 작성자는 5 QPS가 특히 동시 사용자가 많을 때 트래픽이 많은 애플리케이션에 충분하지 않을 수 있다고 지적합니다.
  • 안티봇 처리: DeepSeek가 Cloudflare 챌린지, CAPTCHA 또는 기타 봇 보호를 어떻게 처리하는지에 대한 질문이 남아 있습니다. 문서에는 명시되어 있지 않습니다.
  • 대체 솔루션: 일부 사용자는 개인 프로젝트에 searxng-ai-kit 또는 오픈 소스 fetch 서비스 (Jina, Parallel, Firecrawl, Tavily, Exa)와 같은 무료 자체 호스팅 옵션이 더 비용 효율적이라고 지적합니다.
  • 통합 참고 사항: DeepSeek 자체 Harness, Claude Code 또는 Codex를 사용할 때 Search/Fetch 호출은 현재 무료입니다. 청구는 2026년 11월 1일 00:00 베이징 시간에 시작됩니다.

실용적인 사용 팁

핵심 요점: 비용을 최소화하고 제한을 유지하려면 필요한 필드만 요청하고 가능하면 결과를 재사용하십시오.

  1. need_content=false로 설정 – 다운스트림 모델이 전체 페이지 텍스트를 명시적으로 요구하지 않는 한, 불필요한 데이터 전송을 피할 수 있습니다.
  2. 쿼리 배치 – count 제한(최대 50)까지 쿼리를 배치하여 HTTP 호출 수를 줄입니다.
  3. 성공적인 결과 캐시 – 반복 쿼리의 경우 성공적인 결과를 캐시하면 캐시된 항목은 다시 청구되지 않습니다.
  4. QPS 제한 준수 – HTTP 429 응답에 지수 백오프를 추가하여 QPS 제한을 준수합니다.
  5. 청구 모니터링 – DeepSeek 대시보드를 통해 성공적이고 비어 있지 않은 응답만 $0.75/1k 요금에 포함되는지 확인합니다.

결론

DeepSeek의 Search 및 Fetch API는 성공적인 요청 1,000회당 $0.75로 LLM 에이전트에게 저렴하고 토큰 비용과 무관한 웹 접근을 제공하며, 적당한 5 QPS 제한과 OpenAI 호환 오류 처리를 갖추고 있습니다. 가격이 주요 경쟁사보다 낮지만, 개발자는 비율 제한 제약, 안티봇 견고성 및 빈 결과 청구의 미묘한 차이를 처리해야 합니다.

Sources

관련