DeepSeek đã mở hai API độc lập cho nhà phát triển: Search để tìm các trang web theo truy vấn và Fetch để lấy nội dung của một URL dưới dạng Markdown. Hãng cho biết Search sử dụng công cụ tìm kiếm nội bộ, giúp các ứng dụng AI và hệ thống tạo sinh tăng cường truy xuất (RAG) tiếp cận nội dung web cập nhật mà không cần tích hợp một nhà cung cấp tìm kiếm bên thứ ba.
14
23
24
Endpoint và xác thực
Cả hai API đều nhận và trả dữ liệu JSON, dùng chung xác thực Bearer với DeepSeek API. URL gốc là https://api.deepseek.com; các endpoint được công bố gồm:
23
- Search:
POST https://api.deepseek.com/v1/tools/search
- Fetch:
POST https://api.deepseek.com/v1/tools/fetch
Search: tham số và kết quả
Search yêu cầu trường query không rỗng, dài từ 1 đến 128 ký tự Unicode. Tham số count quy định số kết quả: mặc định là 10, có thể đặt từ 1 đến 50. Tài liệu tích hợp còn liệt kê các trường tùy chọn ori_question, localization và need_content; trong đó, need_content mặc định là false. Tuy nhiên, phần tài liệu hiện có chưa làm rõ đầy đủ ý nghĩa hay định dạng cần truyền cho từng trường tùy chọn.
17
36
Tài liệu API chính thức nêu các cú pháp truy vấn được hỗ trợ gồm site: để giới hạn theo tên miền, -site: để loại trừ tên miền và cụm từ đặt trong dấu ngoặc kép. Một tài liệu tích hợp cũng liệt kê -term, lang:, after: và before:; nên xem đây là thông tin tham khảo từ bên tích hợp, không phải bảo đảm đầy đủ về hành vi API.
17
34
API trả về danh sách kết quả có cấu trúc và được xếp hạng. Tài liệu từ một bên tích hợp liệt kê các trường như title, url, snippet, summary và, nếu được yêu cầu, content; ngoài ra còn có date, rerank_score và authority. Tài liệu này mô tả snippet thường dài 100–200 ký tự, còn summary khoảng 600–800 ký tự. Vì các chi tiết về trường dữ liệu và độ dài này không đến từ phần trích dẫn tài liệu API chính thức, nhà phát triển nên kiểm tra schema phản hồi hiện hành trước khi phụ thuộc vào chúng.
36
Fetch: lấy trang web thành Markdown
Fetch yêu cầu một URL dài tối đa 8.192 ký tự. Theo tài liệu API, URL phải dùng HTTP hoặc HTTPS, có tên máy chủ và không chứa tên người dùng hay mật khẩu. Phản hồi cung cấp tiêu đề trang cùng nội dung ở định dạng Markdown.
18
Tài liệu hiện có không khẳng định API truy cập được mọi website, cũng chưa mô tả đầy đủ các giới hạn trích xuất hay mọi trường hợp lỗi. Vì vậy, không nên mặc định Fetch sẽ lấy được nội dung hoàn chỉnh từ bất kỳ URL nào.
18
Giá và thời gian miễn phí tạm thời
DeepSeek công bố mức giá 0,75 USD cho mỗi 1.000 yêu cầu thành công của từng endpoint. Các bài đưa tin cho biết yêu cầu thất bại, không có kết quả hoặc hết thời gian chờ sẽ không bị tính phí. Một tài liệu tích hợp cũng lưu ý phí truy xuất được tính riêng với phí token của mô hình; nói cách khác, giá gọi Search hoặc Fetch không bao gồm chi phí mô hình xử lý nội dung được lấy về.
2
13
24
Theo thông báo ra mắt, các lượt gọi Search và Fetch thông qua công cụ máy chủ trong DeepSeek Harness, Claude Code và Codex được miễn phí tạm thời đối với người dùng DeepSeek API. Thời điểm bắt đầu tính phí được ấn định là 16:00 UTC ngày 31/10/2026, tức 00:00 ngày 1/11 theo giờ Bắc Kinh. Ưu đãi này áp dụng cho các tích hợp công cụ nêu trên, không đồng nghĩa mọi lượt gọi trực tiếp đến API đều được miễn phí.
2
24
Giới hạn tốc độ: điều gì đã rõ, điều gì chưa?
Một số bài viết thứ cấp cho biết Search và Fetch bị giới hạn ở 5 yêu cầu mỗi giây trên mỗi tài khoản.
4
10 Tuy nhiên, tài liệu được cung cấp chưa xác nhận hai endpoint có hạn mức độc lập hay không, giới hạn được tính theo tài khoản hay theo API key, Fetch có hạn mức bổ sung theo từng tên miền hay không, cũng như API phản hồi thế nào khi vượt ngưỡng.
17
18
Tài liệu giới hạn tốc độ của DeepSeek có đề cập riêng đến giới hạn số yêu cầu đồng thời của các mô hình, nhưng phần thông tin hiện có không giải thích mối liên hệ giữa giới hạn đó với lưu lượng Search và Fetch. Tài liệu cũng chưa xác nhận rằng vượt hạn mức Search hoặc Fetch luôn dẫn đến phản hồi HTTP 429.
25
Tóm lại: tài liệu ra mắt xác nhận các giao diện Search và Fetch, công cụ tìm kiếm nội bộ đứng sau Search và cách tính phí theo yêu cầu. Với những chi tiết chưa được mô tả đầy đủ—đặc biệt là định dạng các trường tùy chọn, schema phản hồi hoàn chỉnh và cách xử lý tình huống ngoại lệ—hãy kiểm tra tài liệu API hiện hành thay vì coi ghi chú của bên tích hợp là cam kết chính thức của dịch vụ.
17
18
23