給 agent 用的搜尋與抓取
DeepSeek 在官方 API 文件新增〈Search & Fetch〉頁面，提供兩支讓 agent 與 RAG 應用存取即時網頁的 API：
- Search API：輸入查詢，回傳結構化的搜尋結果。文件寫明由 DeepSeek 自家搜尋引擎驅動。
- Fetch API：抓取單一網頁，並把內容轉成 Markdown 回傳。
兩者都是純 JSON API，沿用 DeepSeek API 的 bearer 驗證，端點分別是 POST https://api.deepseek.com/v1/tools/search 與 /v1/tools/fetch。
兩支 API 各回傳什麼
依官方文件整理：
| 項目 | Search | Fetch |
|---|---|---|
| 主要輸入 | query（1 至 128 個字元） |
url（最長 8,192 字元） |
| 結果數 | count 1 至 50，預設 10 |
單一頁面 |
| 回傳內容 | 標題、網址、snippet、summary、可選全文 | 標題與 Markdown 內文 |
| 其他欄位 | rerank_score（0 至 3）、authority（0 至 4） |
無 |
Search 支援 site:、-site:、lang:、after:、before:、精確片語等查詢運算子。文件說明 rerank_score 達 1.5 以上屬高品質結果，authority 3 以上代表高權威來源。
只為成功請求付費
計費方式不看 token，也不看回傳幾筆結果：
| API | 單位 | 價格 |
|---|---|---|
| Search | 每 1,000 次成功請求 | US$0.75 |
| Fetch | 每 1,000 次成功請求 | US$0.75 |
只有回傳 HTTP 200 且有結果才計費：Search 要有非空的 results，Fetch 要有頁面內容。失敗、空結果與逾時都不收費，count 調多少也不影響單價。
文件另外註明：透過 DeepSeek Harness、Claude Code 或 Codex 使用 DeepSeek API 時，伺服器端工具呼叫已經會用到這兩支 API，目前免費，北京時間 2026 年 11 月 1 日 00:00 起開始按次計費。
每秒上限與錯誤處理
每個帳號的 Search 與 Fetch 各自限制 每秒 5 次（QPS），互不佔用額度，且以帳號計算，與用哪把 API key 無關。Fetch 另有針對單一網域的 QPS 限制，超過一樣會收到 HTTP 429。
文件建議：遇到 408、429 或 5xx 可等待後重試；402 代表餘額不足，要先儲值；其他 4xx 不改請求就不要重試。對要做大量爬取的 agent 來說，每秒 5 次是規劃排程時的重要前提。
