メインコンテンツへスキップ
DeepSeekは、リアルタイムのWebデータを必要とするエージェントやRAGパイプライン向けに、2つの独立したツールAPIを提供しています:
  • Search:クエリを送信し、構造化されたWeb検索結果(タイトル、リンク、要約、任意のページ本文)を取得します
  • Fetch:URLを送信し、すでにMarkdownへ変換されたページ本文を取得します
これらはチャットモデルではありません。tokenを消費せず、成功したリクエストごとに課金されます。コード側で検索のタイミングと内容を決定し、その結果を任意のモデルに渡します。
モデル名:deepseek-search、deepseek-fetch。エンドポイント:POST /v1/tools/search、POST /v1/tools/fetch。default / svip グループで利用可能です。 このページのすべてのデータは、2026年10月21日 (UTC+8) 時点のAPIYIによるテスト結果に基づいています。
ClaudeCodeグループのキーでは、これら2つのAPIを呼び出すことはできません。 503 no available channels for model deepseek-search が返されます。default または svip グループで個別のキーを作成してください。

概要と使い分け

一般的なパターンは**「まずSearchを実行し、その後いくつかの結果をFetchする」**ことです。各結果の summary だけでモデルが関連性を判断するには十分なため、全文が必要なページのみを取得してください。

Claude Code の組み込み検索との関係

このページで説明しているのは通常の API です。コードから /v1/tools/search および /v1/tools/fetch を直接呼び出します。 Claude Code や Codex などのクライアントでは、モデルによって開始されるWeb検索は chat API 内のサーバー側ツール(web_search)を経由するため、別物となります。APIYI では、今後のリリースでこれらのクライアントにおける DeepSeek モデル向けの組み込み検索をサポートする予定であり、別途アナウンスいたします。

料金

価格を一言で表すと:「20%ボーナスが適用される大口チャージのお客様」を基準に設定されており、ボーナス適用後は公式価格と同等になります。 定価は1リクエストあたり$0.0009ですが、20%のチャージボーナスを適用すると実質コストは1リクエストあたり$0.00075となり、DeepSeekの公式価格と同額になります。10%ボーナスが適用される一般のお客様の場合、公式価格の約1.09倍のお支払いとなります。価格は税込であり、請求書の発行に対応しています。DeepSeekはこれらのAPIに対して割引を提供しておらず、APIYIも利益を目的とした価格設定を行っていません。これらは安定供給の確保とお客様へのサービス提供を目的として提供されています。APIYIのキーが1つあれば、別途DeepSeekのアカウント作成やチャージを行うことなく、search、fetch、およびすべての主要モデルをご利用いただけます。
モデルの価格は公式価格に連動しており、公式価格の改定に伴い変動する場合があります。上記の表は参考用であり、トップナビゲーションのモデル価格タブが正式な情報源となります:モデル価格。
課金ルール(公式APIと同様):
  • リクエストが成功した場合のみ課金されます:結果が返されたHTTP 200
  • パラメータエラー(400)および取得失敗(404)は課金されません
  • 料金はcount、need_content、またはレスポンスの長さには依存しません:結果が1件であっても、ページ本文を含む50件の結果であっても、同じ1回のリクエストとして扱われます
  • 各呼び出しはコンソールログ内でモデル名deepseek-searchまたはdeepseek-fetchとして個別の行に記録されるため、モデルごとに照合できます

クイックスタート

リクエストボディに model フィールドを含める必要はありません。送信された場合でも無視されます。

リクエストパラメータ

検索: POST /v1/tools/search

検索演算子(query 内):

フェッチ: POST /v1/tools/fetch

レスポンスフィールド

Search は {"results": [...]} を返します。各結果には以下が含まれます: Fetch は {"title": "...", "content": "..."} を返します。ここで content は Markdown 本文です。

テスト結果

2026-10-21 (UTC+8) にテスト実施:

事前に知っておくべきこと

検索エンジンはほぼ常に何らかの結果を返します。テストでは、ランダムな文字列を入力した場合でも 3 件の結果が返され、課金対象となりました。 同様に、一部のサイトでは存在しないページに対して 404 を返さず、ホームページやお知らせページを表示します(「ソフト 404」)。Fetch はこれを取得成功とみなし、課金対象とします。 呼び出しを行う前に、ご自身のコード側でクエリと URL の検証を行ってください。
対象ページが 404 であるか、ドメインが存在しないか、プライベートアドレスであるか、またはサイト側からアクセスを拒否されたかに関わらず、Fetch が利用可能なコンテンツを取得できない場合は常に 404 failed to fetch URL を返します。 エラーレスポンス本文内の type フィールドは常に shell_api_error となるため、エラーを識別するには HTTP ステータスコードと message を組み合わせて判別してください。 400 の場合はパラメータを修正し、404 の場合は別の URL を試し、429 / 5xx の場合は少し待ってから再試行してください。
Search および Fetch はインターネット上の未加工のコンテンツを返すため、広告、誤った情報、さらには AI を標的とした prompt インジェクションが含まれている可能性があります。 結果をモデルに渡す際は、これが指示ではなく外部のウェブコンテンツであることを明示的に伝えてください。ウェブページやアプリで結果を表示する際は、HTML をエスケープしてください。
アップストリームの制限は、Search が 100 QPS、Fetch が 25 QPS であり、Fetch には対象ドメインごとに個別の制限が設けられています。 制限を超えると 429 が返されます。少し待ってから再試行してください。同一サイトから多数のページを取得する場合は、クライアント側でスロットリングを行ってください。

よくある質問

これらはチャットモデルの組み込みtoolsです。モデル自身が検索するかどうか、および検索内容を決定し、検索は追加のtools呼び出しとして課金されます(OpenAI web_search は1,000回の呼び出しあたり$10です)。 本ページで提供しているのはスタンドアロンの検索APIです。コード側でいつ何を検索するかを決定でき、単価はそのごくわずかな一部であり、結果は任意のモデルに渡すことができます。 組み込みtoolsについては、OpenAI Web検索、Claude Web検索、およびGemini Web検索を参照してください。
現時点では直接使用できません。Claude Code内でモデルが開始するウェブ検索は、本APIではなくチャットAPIのサーバー側ツールを経由します。また、ClaudeCodeグループのキーでも本APIを呼び出すことはできません。APIYIは今後のリリースで、これらのクライアントにおけるDeepSeekモデルの組み込み検索をサポートする予定です。
結果にはdateフィールドが含まれており、after:演算子を使用して最新のコンテンツのみを取得できます。テストでは、当日に公開されたニュースも表示されました。

関連ドキュメント

Search Playground

パラメータリファレンス、エラーコード、ライブリクエストパネル

Fetch Playground

任意のWebページをMarkdownとして取得

DeepSeek V4 Flash

組み合わせて利用できるチャットモデル

チャージボーナス

チャージ額が多いほどボーナスが増加し、大口チャージのお客様は公式価格でご利用いただけます