Hacker News

DeepSeek search and fetch – $0.75 per 1000 successful requests

DeepSeek Search와 Fetch API, 성공 요청 1,000건당 0.75달러

DeepSeek가 에이전트와 RAG 애플리케이션용 Search API와 Fetch API를 공개했습니다. 두 API 모두 성공 요청 1,000건당 0.75달러이며, 검색 결과 수와 무관하게 요청 단위로 과금합니다. 계정별 요청 한도는 각각 초당 5회입니다.

에디터 노트

요금 구조는 단순합니다. 결과 개수나 토큰이 아니라 성공 요청에 과금하고, 빈 검색과 실패 요청은 제외합니다. Search와 Fetch가 각각 초당 5회로 제한되므로 개인 에이전트에는 저렴한 선택지가 될 수 있지만, 동시 사용자가 많은 서비스는 계정별 한도와 Fetch의 도메인별 한도를 먼저 고려해야 합니다. 댓글에서 제기된 봇 방지 우회 문제는 이 API 문서가 답하지 않습니다. 문서는 대상 사이트의 접근 정책에 따라 Fetch 결과가 달라진다고만 설명합니다. 따라서 댓글의 robots.txt 준수 추측이나 다른 서비스의 우회 방식에 관한 주장은 DeepSeek의 동작을 확인한 근거로 볼 수 없습니다. 자체 검색과 페이지 수집을 한 API로 제공하는 편의성은 분명하지만, 사이트 접근 허용 범위와 실제 수집 성공률은 자료에서 확인되지 않습니다.

AI 요약

DeepSeek가 웹 검색과 페이지 수집을 위한 Search API와 Fetch API를 제공합니다. 두 API는 기존 DeepSeek API와 같은 Bearer 인증을 사용하며, JSON 요청을 받습니다. Search는 자체 검색 엔진으로 질의를 처리해 구조화한 결과를 반환하고, Fetch는 지정한 웹페이지의 제목과 본문을 Markdown으로 돌려줍니다.

Search API

POST https://api.deepseek.com/v1/tools/search로 요청합니다. 필수 항목은 1~128자 질의이며, 결과 수는 기본 10개, 최소 1개에서 최대 50개까지 지정합니다. 원래 질문을 함께 보내 검색 질의를 보완할 수 있고, IP 주소로 결과 지역화를 요청할 수도 있습니다. need_content를 true로 설정하면 결과별 페이지 본문을 요청합니다. 기본값은 false이며, 콘텐츠를 가져올 수 없으면 content는 빈 문자열입니다.

질의에는 site:, -site:, 제외어와 정확한 문구 검색, lang:, after:, before: 연산자를 사용할 수 있습니다. 응답에는 제목, URL, 짧은 snippet, 모델이 읽도록 구성한 600~800자 분량의 summary 등이 담깁니다. rerank_score는 0~3점이며 1.5점 이상을 고품질 결과로 봅니다. authority는 -1부터 4까지이고, 3 이상은 권위가 높은 출처를 나타냅니다.

Fetch API

POST https://api.deepseek.com/v1/tools/fetch에 가져올 URL을 보냅니다. URL은 HTTP 또는 HTTPS 주소여야 하고, 사용자 이름이나 비밀번호를 포함할 수 없습니다. 성공하면 페이지 제목과 Markdown 본문을 반환합니다. 대상 사이트의 가용성과 접근 정책에 따라 수집 결과가 달라집니다. 접근이 거부되거나 콘텐츠를 추출하지 못하면 HTTP 404를 반환할 수 있습니다.

요금과 제한

Search와 Fetch는 각각 성공 요청 1,000건당 0.75달러입니다. Search는 결과 배열이 비어 있지 않고 Fetch는 페이지 본문을 반환해야 과금됩니다. 실패한 요청, 빈 검색 결과, 시간 초과는 과금하지 않습니다. Search의 count 값은 결과 개수만 조절하며 요금에는 영향을 주지 않습니다. DeepSeek Harness, Claude Code, Codex에서 발생하는 서버 측 도구 호출은 2026년 11월 1일 베이징 시간 00시부터 요청별 과금을 시작한다고 안내합니다. 그전까지는 무료입니다.

계정별 한도는 Search와 Fetch 각각 초당 5회이며 API 키별 한도가 아닙니다. Fetch에는 도메인별 초당 요청 제한도 적용됩니다. 한도를 넘으면 HTTP 429가 돌아옵니다. HTTP 408, 429, 5xx는 기다린 뒤 재시도하도록 안내하고, 잔액 부족을 뜻하는 402는 충전 후 다시 요청해야 합니다. 그 밖의 4xx 오류는 요청을 고치지 않은 채 재시도하지 말라고 명시합니다.

Hacker News 반응

  • @Havoc — 비교 기준으로 Exa는 1,000건에 4달러를 받습니다.
  • @thombles — 비교하면 Brave Search API는 5달러, Kagi API는 12달러입니다.
    • @ece — Exa는 4달러, SERP API는 1.50달러입니다.
    • @wmchen — Ceramic.ai는 검색 1,000건에 0.25달러입니다. OpenCode에서 MCP 플러그인으로 쓰고 있는데 괜찮은 수준입니다. 많이 언급되지 않고 Exa나 Tavily와 비교 평가도 해보지 않았습니다.
  • @Doohickey-d — 이 서비스와 비슷한 서비스는 봇 방지 기능을 얼마나 잘 처리하나요? Cloudflare 체크박스나 Anubis로 보호된 페이지를 가져오면 오류가 나나요, 쓸 만한 콘텐츠가 없나요, 아니면 원하는 실제 콘텐츠를 얻나요?
    • @weird-eye-issue — 하나로 답할 수 없습니다. 서비스와 페이지에 따라 달라집니다. Claude와 ChatGPT 같은 미국 서비스 대부분은 차단하기 쉬운 특정 User-Agent를 보내며 봇 방지를 우회하려고 하지 않습니다. 다른 서비스는 브라우저 User-Agent, 데이터센터 IP나 주거용 IP 등 여러 방식을 쓰기도 합니다. 결국 사이트별 설정에 달려 있어 결과가 들쭉날쭉합니다.
    • @tyre — 검색 API는 자체 색인으로 보이는 결과를 반환합니다. 실제 페이지를 방문하려면 봇 감지를 우회할 방법이 필요합니다. 사이트 소유자에게는 Anubis를 쓰는 이유 중 하나가 AI 업체의 끊임없는 요청을 막기 위해서입니다. DeepSeek가 몇 시간에 한 번만 크롤링한다면 사이트 트래픽 부담을 줄이면서 접근을 허용할 수도 있습니다. DeepSeek 검색 크롤러가 robots.txt를 따르는지는 모르겠습니다.
  • @josteink — 표시된 요청 한도는 낮아 보입니다. 초당 5회라면 동시 사용자가 상당한 앱에서는 쓸 수 없을 것 같습니다. 제가 잘못 이해했나요?
    • @alexjurkiewicz — 에이전트용입니다.
  • @gvfsa — Fetch에 왜 요금을 내야 하나요? 로컬에서 실행하는 하네스가 직접 가져오는 줄 알았습니다. 어떻게 요금을 청구하나요?
    • @BlackRabbit1 — 원격 제어 Firefox나 Chrome을 쓰지 않으면 Python이나 curl로 보내는 로컬 요청 대부분은 실패합니다. 그런 브라우저를 써도 CAPTCHA에 막혀 대량 요청에는 사실상 쓸 수 없습니다. 안정적인 API를 제공하는 외부 서비스에 웹 검색을 맡기는 편이 낫습니다. 로컬 하네스용 무료 검색 서비스는 품질이 낮습니다. LLM이 기존 정보와 코드에 더 가까이 접근하도록 도우려면 비용을 들일 만합니다.
  • @0-bad-sectors — DeepSeek는 가져온 페이지의 콘텐츠 제작자에게 비용을 지급하나요?
    • @ranguna — 본인은 지급하나요?
  • @nikvdp — 호스팅 검색 서비스는 실제로 어떤 용도로 쓰나요? 개인 용도라면 searxng-ai-kit이나 비슷한 도구가 훨씬 비용 효율적이고 무료라고 생각합니다. 저는 해당 도구의 작성자입니다. oh-my-pi도 비슷한 방식을 써서 API 키나 검색 업체 없이 기본 설정만으로 검색 결과를 수집합니다.

원문: DeepSeek API 문서 / 번역·요약: Trawling