ホーム › 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トークンです。

エンドポイント
APIURLできること
SearchPOST https://api.deepseek.com/v1/tools/search検索語に合うページを探し、結果の一覧を返す
FetchPOST https://api.deepseek.com/v1/tools/fetch1つのURLのページ内容をMarkdownで返す

公式の更新履歴(2026年10月17日)は、このAPIの元になった検索エンジンについて、WebとAPIの検索を支える自社のDeepSeek Searchで、数千億ページを索引にしていると説明しています。SEOスパムや低品質なAI生成の文章を取り除く仕組みがあるとも書かれています。これは公式の説明であり、このサイトで検証した結果ではありません。

検索演算子

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単位料金
Search1,000回の成功$0.75
Fetch1,000回の成功$0.75

課金されるのは、HTTP 200で結果が得られたときだけです。Searchは結果の配列が空でないとき、Fetchはページ内容が得られたときです。失敗、空の検索結果、タイムアウトは課金されません。countを増やしても単価は変わりません。例えば、Searchを1万回成功させると $0.75 × 10 = $7.5 です。

DeepSeek Harness・Claude Code・Codexの中のツールが呼ぶSearchとFetchも、同じく成功した回数で課金されると公式に書かれています。開発ツールで使う場合は、この課金が別に加わる点に注意します。

レート制限(アカウント単位のQPS)
API上限
Search100
Fetch25(取得先のドメイン単位の上限もあり)

上限はAPIキーごとではなくアカウント単位で、モデルの同時接続の上限とは別です。超えると429が返ります。

エラーの扱い

主なエラー(公式の記載)
状態意味対処
400ヘッダーや本文の誤りリクエストを直す。再試行しない
401キーが無い・無効キーを確認する
402残高不足チャージしてから再試行する
403Fetchが安全方針で拒否された別のURLを検討する
404Fetchで使える内容を取得できなかったURLと内容の種類を確認する
408・429・5xx・504タイムアウト・上限超過・内部エラー待って再試行する

SearchとFetchは読み取り専用です。公式は、408・429・5xxは待って再試行し、402はチャージしてから再試行し、それ以外の4xxは内容を変えずに再試行しないよう案内しています。モデル側のエラーコードはAPIエラーコードの一覧にあります。

確認した公式資料

上の資料は2026年11月11日に確認しました。内容は予告なく変わるため、使う前に公式のページで最新の表示を確かめてください。サンプルコードは公式の例をもとに、このサイトで読みやすく書き換えたものです。

あわせて読むページ

よくある質問

Search APIの料金は結果の件数で変わりますか?

変わりません。1,000回の成功ごとに$0.75で、countを増やしても単価は同じです。失敗や空の結果は課金されません。

Fetch APIは、どんなページでも取得できますか?

いいえ。取得先のサイトの状態やアクセス方針に左右され、取得できなければ404などが返ります。

Search APIとFetch APIのレート制限はモデルと共通ですか?

別です。アカウント単位でSearchは100、Fetchは25のQPSが独立して設けられ、モデルの同時接続の上限とも別です。