DeepSeek 검색·가져오기 API는 성공 요청 1천 건에 0.75달러다

DeepSeek가 웹 검색 결과를 제공하는 Search API와 웹페이지를 마크다운으로 가져오는 Fetch API를 제공한다. 두 API 모두 성공한 요청 1,000건당 0.75달러이며, 토큰 수나 검색 결과 수에 따라 요금이 달라지지는 않는다.

두 API는 https://api.deepseek.com을 기본 주소로 사용하고, Bearer 방식의 DeepSeek API 키와 application/json 헤더로 인증한다. Search API는 POST https://api.deepseek.com/v1/tools/search, Fetch API는 POST https://api.deepseek.com/v1/tools/fetch로 요청한다. Search API 참고 문서와 Fetch API 참고 문서에서 요청·응답 형식을 확인할 수 있다.

Search API는 검색어와 함께 반환할 결과 수를 지정할 수 있다. 기본값은 10개이며 1~50개 범위에서 설정한다. 페이지 내용을 함께 받으려면 need_content를 켜야 한다. 검색 결과가 없으면 빈 배열이 반환되며 요금이 부과되지 않는다. Fetch API는 URL 하나를 받아 페이지 제목과 마크다운 본문을 반환한다. 대상 사이트의 가용성과 접근 정책에 따라 가져오기가 제한될 수 있다.

요금은 HTTP 200 응답과 결과가 모두 있어야 발생한다. Search는 results 배열이 비어 있지 않아야 하고, Fetch는 페이지 콘텐츠를 반환해야 한다. 요청 실패, 빈 검색 결과, 시간 초과에는 요금이 부과되지 않는다. Search의 count는 결과 수만 바꾸며 요청당 가격에는 영향을 주지 않는다.

DeepSeek API를 DeepSeek Harness, Claude Code 또는 Codex를 통해 사용할 때 서버 측 도구 호출은 현재 무료이며, 요청당 과금은 2026년 11월 1일 베이징 시간 00시에 시작된다. 계정별 초당 요청 한도는 Search와 Fetch 각각 5회다. Fetch에는 도메인별 한도도 적용되며, 한도를 넘으면 HTTP 429 응답을 받을 수 있다.

부록: 원문 예시

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/search",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={        "query": "DeepSeek V4 release",        "count": 5,        "need_content": True,    },)response.raise_for_status()for result in response.json()["results"]:    print(result["title"], result["url"])    print(result["summary"])

import requestsresponse = requests.post(    "https://api.deepseek.com/v1/tools/fetch",    headers={        "Authorization": "Bearer <DeepSeek API Key>",    },    json={"url": "https://example.com/article"},)response.raise_for_status()page = response.json()print(page["title"])print(page["content"])