Tìm kiếm web DeepSeek

POST/v1/tools/search

Xác thực

bearerAuth

Xác thựcBearer <token>

Dùng API Key do nền tảng cấp.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

Các trường không xác định bị phía thượng nguồn bỏ qua, không dùng để chọn mô hình hoặc nhóm.

query*string

Truy vấn được tính theo ký tự Unicode, không được chỉ gồm khoảng trắng. Hỗ trợ cú pháp tìm kiếm theo trang, ngôn ngữ, ngày và từ khóa.

Mẫu khớp\S

Độ dài1 <= length <= 128

count?integer

Số kết quả trả về; không ảnh hưởng đến giá mỗi yêu cầu.

Phạm vi1 <= value <= 50

Giá trị mặc định10

need_content?boolean

Có trả về nội dung trang hay không. Khi false, mỗi content là chuỗi rỗng; khi true, nội dung không có sẵn vẫn có thể rỗng.

Giá trị mặc địnhfalse

ori_question?string|null

Câu hỏi gốc kích hoạt tìm kiếm, giúp làm rõ ý định; null được coi là không cung cấp.

Độ dài1 <= length <= 128

localization?string

Địa chỉ IP dùng để ưu tiên kết quả tìm kiếm theo địa phương.

Giá trị mặc định""

Nội dung phản hồi

`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
  }'

Chỉ hiển thị một kết quả; văn bản dài đã được rút gọn.

{
  "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
    }
  ]
}

Cú pháp tìm kiếm

Kết hợp từ khóa với các toán tử sau trong query; không cần trường yêu cầu bổ sung.

Toán tử	Cách dùng
`site:`	`DeepSeek site:github.com` giới hạn trang web; nối nhiều trang bằng `OR`
`-site:`	`DeepSeek -site:example.com` loại trừ trang web
`-`, `-"..."`	`DeepSeek -ads -"release notes"` loại trừ từ khóa hoặc cụm từ
`"..."`	`DeepSeek "exact phrase"` khớp toàn bộ cụm từ
`lang:`	`DeepSeek lang:zh,en` giới hạn ngôn ngữ; phân cách nhiều ngôn ngữ bằng dấu phẩy
`after:`, `before:`	`DeepSeek after:2026-01-01 before:2026-11-01` giới hạn ngày xuất bản; cũng có thể chỉ ghi năm

HTTP 200 với results không rỗng được tính là một yêu cầu thành công. Kết quả rỗng, thất bại và hết thời gian chờ không bị tính phí. count và need_content không làm tăng số yêu cầu tính phí mỗi lần gọi. Phản hồi không trả thêm usage.

Để đọc toàn bộ nội dung trang đã chọn, dùng lấy nội dung web. Xem hướng dẫn để kết hợp API và tìm kiếm bằng mô hình.

Tài liệu chính thức DeepSeek SearchXem định nghĩa API thượng nguồn và các thay đổi trường mới nhất.

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

401application/json

Cú pháp tìm kiếm

Tính phí và sử dụng

`application/json`

`application/json`

`application/json`