DeepSeek Search & Fetch API の料金と機能概要

DeepSeek Search & Fetch API は成功した呼び出し1,000回あたり0.75ドルで、LLMエージェントにとって手頃なライブウェブアクセスを実現

DeepSeekは、言語モデルエージェントがライブのウェブ結果とページコンテンツを取得できるようにする、2つの新しい生JSONエンドポイント – Search と Fetch を発表しました。どちらのAPIも、返される結果の数に関係なく、成功したリクエストごとに 1,000回あたり0.75ドル で課金されます。

Search APIはクエリに対して構造化された結果を提供

重要なポイント: Searchエンドポイントは、タイトル、URL、スニペット、要約、およびオプションの全ページコンテンツを含む、最大50件のランク付けされた結果を返します。

  • エンドポイント: POST https://api.deepseek.com/v1/tools/search
  • 認証: Authorization ヘッダー内のベアラートークン。Content-Type: application/json が必要です。
  • リクエストフィールド (すべてJSON):
    • query (文字列、1〜128文字、必須)
    • count (整数、デフォルト10、1〜50)
    • ori_question (文字列、オプション、最大128文字)
    • localization (文字列、オプションのIPアドレス)
    • need_content (ブール値、デフォルトfalse) – trueの場合、レスポンスにはページの完全なMarkdownコンテンツが含まれます。
  • サポートされているクエリ演算子 には、site:、-site:、-、-"..."、"..."、lang:、after:、before: が含まれます。演算子は単一のクエリで組み合わせることができます。
  • レスポンススキーマ (200 OK):
    {
  "results": [
    {
      "rerank_score": 2.4,
      "title": "DeepSeek V4 model released",
      "url": "https://example.com/deepseek-v4",
      "snippet": "...",
      "summary": "...",
      "content": "...",   // present only if need_content=true
      "site_name": "Example News",
      "site_icon": "https://example.com/favicon.ico",
      "date": "2026-06-01T00:00:00+00:00",
      "authority": 3
    }
  ]
}
  • スコアリング: rerank_score は0〜3の範囲です。スコア≥1.5は高品質の結果を示します。authority 3〜4は、権威のあるソースを示します。
  • 課金ルール: リクエストがHTTP 200を返し、かつ results 配列が空でない場合にのみ課金されます。
  • レート制限: アカウントあたり5 QPS（Fetchとは独立）。制限を超えるとHTTP 429が返されます。

Fetch APIはページのMarkdownコンテンツを返す

重要なポイント: Fetchエンドポイントは単一のURLを取得し、そのタイトルと完全なMarkdown本文を返します。これも成功した呼び出し1,000回あたり0.75ドルで課金されます。

  • エンドポイント: POST https://api.deepseek.com/v1/tools/fetch
  • 認証: Searchと同じベアラートークンスキーム。
  • リクエストフィールド: url (文字列、必須、最大8192文字、資格情報を含まない有効なHTTP/HTTPS URLである必要があります)。
  • レスポンススキーマ (200 OK):
    {
  "title": "Example article",
  "content": "# Example article\n\nArticle content."
}
  • 課金ルール: リクエストがHTTP 200を返し、かつ content フィールドが空でない場合にのみ課金されます。
  • レート制限: アカウントあたり5 QPSに加えて、ドメインごとの追加のQPS制限があります。違反するとHTTP 429が返されます。

エラーハンドリングはOpenAI互換形式に従う

重要なポイント: エラーは error.message、error.type、error.code を含むJSONオブジェクトを返します。param フィールドは常に null です。

HTTPステータス 一般的な原因
400 JSONまたはフィールド値が無効（例: count が範囲外）
401 APIキーが欠落しているか無効
402 アカウント残高が不十分
403 ターゲットサイトのセキュリティポリシーによってFetchがブロックされた
404 URLが利用できない、ブロックされている、またはコンテンツを抽出できない
408 リクエスト本文の読み取りタイムアウト
413 リクエスト本文が大きすぎる
429 QPS制限を超えた
500 内部サーバーエラー
504 ダウンストリームタイムアウト

再試行ガイダンス: 408、429、または5xxエラーの場合は待って再試行してください。リクエストを修正せずに他の4xxエラーを再試行しないでください。

価格と制限に関するコミュニティの見解

重要なポイント: ユーザーはDeepSeekの$0.75/1kという価格を競合他社と比較して好意的に評価していますが、レート制限とアンチボットの堅牢性について懸念を表明しています。

  • 価格比較: Brave Search APIは$5/1k、Kagiは$12/1k、Exaは$4/1kですが、DeepSeekの$0.75/1kは大幅に安価です。
  • レート制限の批判: 複数のコメント投稿者は、特に複数の同時ユーザーが予想される場合、高トラフィックのアプリケーションには5 QPSでは不十分かもしれないと指摘しています。
  • アンチボット処理: Cloudflareチャレンジ、CAPTCHA、その他のボット保護にDeepSeekがどのように対処するかについての疑問が残っています。ドキュメントには指定されていません。
  • 代替ソリューション: 一部のユーザーは、個人プロジェクトでは、searxng-ai-kit やオープンソースのフェッチサービス（Jina、Parallel、Firecrawl、Tavily、Exa）などの無料のセルフホスト型オプションの方が費用対効果が高いと指摘しています。
  • 統合メモ: DeepSeek独自のHarness、Claude Code、Codexを使用する場合、Search/Fetch呼び出しは現在無料です。課金は2026年11月1日午前0時（北京時間）から開始されます。

実用的な使用上のヒント

重要なポイント: コストを最小限に抑え、制限内に収めるために、必要なフィールドのみをリクエストし、可能な場合は結果を再利用してください。

  1. need_content=false を設定 します。ダウンストリームモデルがページの全テキストを明示的に必要としない限り、不要なデータ転送を回避できます。
  2. クエリをバッチ処理 して、count 制限（最大50）までHTTP呼び出しの数を減らします。
  3. 繰り返しのクエリに対して成功した結果をキャッシュ します。キャッシュされたヒットは再度課金されません。
  4. HTTP 429応答に指数バックオフを追加して、QPS制限を尊重 します。
  5. DeepSeekダッシュボードで請求を監視 します。成功した空でない応答のみが$0.75/1kの料金の対象となります。

結論

DeepSeekのSearch APIとFetch APIは、成功したリクエスト1,000回あたり$0.75で、トークンに依存しない低コストのウェブアクセスをLLMエージェントに提供し、控えめな5 QPS制限とOpenAI互換のエラーハンドリングを備えています。価格は主要な競合他社を下回っていますが、開発者はレート制限の制約、アンチボットの堅牢性、および空の結果の請求のニュアンスを処理する必要性を考慮する必要があります。

Sources

関連