DeepSeek 웹 검색

검색어로 웹 링크, 요약과 선택적 페이지 본문을 가져옵니다.

POST/v1/tools/search

인증

bearerAuth

인증Bearer <token>

플랫폼에서 발급한 API Key를 사용합니다.

전달 위치: header

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

알 수 없는 필드는 업스트림에서 무시하며 모델이나 그룹 선택에 사용하지 않습니다.

query*string

Unicode 문자 수로 계산하는 검색어입니다. 공백만 포함할 수 없습니다. 사이트, 언어, 날짜, 키워드 검색 구문을 지원합니다.

패턴\S

길이1 <= length <= 128

count?integer

반환할 결과 개수입니다. 요청당 가격에는 영향을 주지 않습니다.

범위1 <= value <= 50

기본값10

need_content?boolean

페이지 본문 반환 여부입니다. false이면 각 content는 빈 문자열이며, true여도 본문이 없으면 비어 있을 수 있습니다.

기본값false

ori_question?string|null

검색을 유발한 원래 질문으로 검색 의도 파악에 도움이 됩니다. null은 미제공으로 처리합니다.

길이1 <= length <= 128

localization?string

현지화된 검색 결과를 우선하기 위한 IP 주소입니다.

기본값""

응답 본문

`application/json`

curl -X POST "https://example.com/v1/tools/search" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "DeepSeek site:api-docs.deepseek.com",
    "count": 5,
    "need_content": false
  }'

결과 하나만 표시하며 긴 텍스트는 줄였습니다.

{
  "results": [
    {
      "title": "DeepSeek-V4 预览版：迈入百万上下文普惠时代",
      "url": "https://api-docs.deepseek.com/zh-cn/news/news260424/#1",
      "snippet": "DeepSeek-V4 预览版的发布说明。",
      "summary": "该页面介绍 DeepSeek-V4 预览版的上线信息及主要能力。",
      "content": "",
      "rerank_score": 2.070382833480835,
      "site_name": "DeepSeek",
      "site_icon": "https://cdn.deepseek.com/site-icons/deepseek.com",
      "date": "2026-04-23T16:00:00+00:00",
      "authority": 3
    }
  ]
}

검색 구문

query에서 키워드와 다음 연산자를 조합합니다. 추가 요청 필드는 필요하지 않습니다.

연산자	사용법
`site:`	`DeepSeek site:github.com`으로 사이트 제한. 여러 사이트는 `OR`로 연결
`-site:`	`DeepSeek -site:example.com`으로 사이트 제외
`-`, `-"..."`	`DeepSeek -ads -"release notes"`로 키워드 또는 구문 제외
`"..."`	`DeepSeek "exact phrase"`로 전체 구문 일치
`lang:`	`DeepSeek lang:zh,en`으로 언어 제한. 여러 언어는 쉼표로 구분
`after:`, `before:`	`DeepSeek after:2026-01-01 before:2026-11-01`로 게시일 제한. 연도만 지정해도 됨

과금과 사용

HTTP 200이고 results가 비어 있지 않으면 성공 요청 한 건으로 과금합니다. 빈 결과, 실패, 시간 초과에는 과금하지 않습니다. count와 need_content는 호출당 과금 횟수를 늘리지 않으며, 추가 usage도 반환하지 않습니다.

선택한 페이지의 전체 본문을 읽으려면 웹 가져오기를 사용합니다. 조합 호출과 모델 검색 예시는 가이드를 참조하세요.

DeepSeek Search 공식 문서업스트림 API 정의와 최신 필드 변경 사항을 확인합니다.

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

검색 구문

과금과 사용

`application/json`

`application/json`

`application/json`