ホーム › APIの始め方 › SearchとFetch API
DeepSeekガイド
DeepSeekのSearch APIとFetch API:呼び出し方・演算子・料金
DeepSeekは2026年10月17日に、自社の検索エンジンをAPIとして公開しました。Search APIはWebページを検索して構造化した結果を返し、Fetch APIは1ページを取得してMarkdownで返します。どちらもトークンではなく「成功した回数」で課金されます。2026年11月11日に確認した公式の内容を整理します。
2つのAPIの役割と、エンドポイント
Search APIとFetch APIは、AIエージェントやRAG(検索して答えを作るアプリ)に、最新のWebの内容を渡すための生のJSON APIです。認証はDeepSeek APIと同じBearerトークンです。
| API | URL | できること |
|---|---|---|
| Search | POST https://api.deepseek.com/v1/tools/search | 検索語に合うページを探し、結果の一覧を返す |
| Fetch | POST https://api.deepseek.com/v1/tools/fetch | 1つのURLのページ内容をMarkdownで返す |
公式の更新履歴(2026年10月17日)は、このAPIの元になった検索エンジンについて、WebとAPIの検索を支える自社のDeepSeek Searchで、数千億ページを索引にしていると説明しています。SEOスパムや低品質なAI生成の文章を取り除く仕組みがあるとも書かれています。これは公式の説明であり、このサイトで検証した結果ではありません。
Search APIの使い方
import requests
res = requests.post(
"https://api.deepseek.com/v1/tools/search",
headers={"Authorization": "Bearer <APIキー>"},
json={"query": "DeepSeek V4 release", "count": 5, "need_content": True},
)
res.raise_for_status()
for r in res.json()["results"]:
print(r["title"], r["url"], r["rerank_score"])| 項目 | 必須 | 既定値 | 内容 |
|---|---|---|---|
| query | 必須 | — | 1〜128文字。空白だけは不可。演算子が使える |
| count | 任意 | 10 | 返す件数。1〜50 |
| ori_question | 任意 | — | 検索のきっかけになった元の質問(1〜128文字)。意図の理解を助ける |
| localization | 任意 | 空 | 検索結果を地域に合わせるためのIPアドレス |
| need_content | 任意 | false | trueでページ本文をcontentに入れる。falseのときcontentは空文字 |
返ってくる各結果には、rerank_score(0〜3の関連度。1.5以上が高品質の目安)、title、url、snippet(画面表示用の100〜200文字ほどの要約)、summary(モデルに読ませる用の600〜800文字ほどの要約)、content、site_name、date、authority(0〜4の権威度。3以上が高権威)などが入ります。
検索演算子
queryには、検索の記法がそのまま渡されます。組み合わせて使えます。
| 演算子 | 例 | 意味 |
|---|---|---|
| site: | DeepSeek site:github.com | 指定のサイトに限る。複数はORでつなぐ |
| -site: | DeepSeek -site:example.com | 指定のサイトを除く |
| -語 | DeepSeek -advertisement | その語を含むページを除く |
| "…" | DeepSeek "exact phrase" | 語句と完全に一致させる |
| -"…" | DeepSeek -"release notes" | その語句を含むページを除く |
| lang: | DeepSeek lang:zh,en | 言語コードで絞る(カンマ区切り) |
| after: / before: | DeepSeek after:2025-01-01 | 公開日で絞る(年・年月日の形) |
DeepSeek site:github.com OR site:huggingface.co lang:en after:2025言語の指定は、公式の例のように lang:zh,en と言語コードを並べて書きます。
Fetch API:1ページをMarkdownで取る
res = requests.post(
"https://api.deepseek.com/v1/tools/fetch",
headers={"Authorization": "Bearer <APIキー>"},
json={"url": "https://example.com/article"},
)
page = res.json()
print(page["title"]); print(page["content"])urlは8,192文字以内の、ホストを含むHTTPまたはHTTPSのURLで、ユーザー名やパスワードを含めてはいけません。取得は、取得先のサイトの状態とアクセス方針に左右されます。取得できなかったときは404などが返ります。
料金とレート制限
| API | 単位 | 料金 |
|---|---|---|
| Search | 1,000回の成功 | $0.75 |
| Fetch | 1,000回の成功 | $0.75 |
課金されるのは、HTTP 200で結果が得られたときだけです。Searchは結果の配列が空でないとき、Fetchはページ内容が得られたときです。失敗、空の検索結果、タイムアウトは課金されません。countを増やしても単価は変わりません。例えば、Searchを1万回成功させると $0.75 × 10 = $7.5 です。
DeepSeek Harness・Claude Code・Codexの中のツールが呼ぶSearchとFetchも、同じく成功した回数で課金されると公式に書かれています。開発ツールで使う場合は、この課金が別に加わる点に注意します。
| API | 上限 |
|---|---|
| Search | 100 |
| Fetch | 25(取得先のドメイン単位の上限もあり) |
上限はAPIキーごとではなくアカウント単位で、モデルの同時接続の上限とは別です。超えると429が返ります。
エラーの扱い
| 状態 | 意味 | 対処 |
|---|---|---|
| 400 | ヘッダーや本文の誤り | リクエストを直す。再試行しない |
| 401 | キーが無い・無効 | キーを確認する |
| 402 | 残高不足 | チャージしてから再試行する |
| 403 | Fetchが安全方針で拒否された | 別のURLを検討する |
| 404 | Fetchで使える内容を取得できなかった | URLと内容の種類を確認する |
| 408・429・5xx・504 | タイムアウト・上限超過・内部エラー | 待って再試行する |
SearchとFetchは読み取り専用です。公式は、408・429・5xxは待って再試行し、402はチャージしてから再試行し、それ以外の4xxは内容を変えずに再試行しないよう案内しています。モデル側のエラーコードはAPIエラーコードの一覧にあります。
確認した公式資料
- DeepSeek API Docs「Search & Fetch」
- DeepSeek API Docs「Change Log」(2026年10月17日)
- DeepSeek API Docs「Models & Pricing」
上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。
あわせて読むページ
よくある質問
Search APIの料金は結果の件数で変わりますか?
変わりません。1,000回の成功ごとに$0.75で、countを増やしても単価は同じです。失敗や空の結果は課金されません。
Fetch APIは、どんなページでも取得できますか?
いいえ。取得先のサイトの状態やアクセス方針に左右され、取得できなければ404などが返ります。
Search APIとFetch APIのレート制限はモデルと共通ですか?
別です。アカウント単位でSearchは100、Fetchは25のQPSが独立して設けられ、モデルの同時接続の上限とも別です。