DeepSeekの検索・取得API：成功リクエスト1000件あたり0.75ドル

Search & Fetch

Search APIとFetch APIは、エージェントやRAGアプリケーションにライブのウェブコンテンツへのアクセスを提供します。

• Search API: クエリに基づいてウェブページを検索し、構造化された結果を返します。DeepSeek独自の検索エンジンによって駆動されています。
• Fetch API: 単一のウェブページを取得し、そのコンテンツをMarkdown形式で返します。

どちらも生のJSON APIです。DeepSeek APIと同じベアラートークン認証を使用します。

ベースURLは https://api.deepseek.com です。

完全なリクエストおよびレスポンススキーマについては、Search API Reference および Fetch API Reference を参照してください。

---

認証​

リクエストヘッダーにAPIキーとJSONコンテンツタイプを送信してください。

---

Search API​

リクエスト​

https://api.deepseek.com/v1/tools/search \
  -H "Authorization: Bearer <DeepSeek API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "DeepSeek V4 release",
    "count": 5,
    "need_content": true
  }'

import requests
response = requests.post(
    "https://api.deepseek.com/v1/tools/search",
    headers={
        "Authorization": "Bearer <DeepSeek API Key>",
    },
    json={
        "query": "DeepSeek V4 release",
        "count": 5,
        "need_content": True,
    },
)
response.raise_for_status()
for result in response.json()["results"]:
    print(result["title"], result["url"])
    print(result["summary"])

リクエストフィールド:

リクエストボディ内の不明なフィールドは無視されます。

クエリ演算子​

クエリは検索構文をそのまま転送します。以下の例は演算子と検索語を組み合わせていますが、1つのクエリに複数の演算子を組み合わせることができます。

例:

{
  "query": "DeepSeek site:github.com OR site:huggingface.co lang:en after:2025",
  "count": 10
}

レスポンス​

成功したリクエストはHTTP 200と results 配列を返します。一致するものがなかった通常の検索は、空の配列を返します。

{
  "results": [
    {
      "rerank_score": 2.4,
      "title": "DeepSeek V4 model released",
      "url": "https://example.com/deepseek-v4",
      "snippet": "DeepSeek V4 is now available, with tool calling and long-context support.",
      "summary": "DeepSeek has released the V4 model. The release adds improved tool calling and long-context support for agent workflows.",
      "content": "DeepSeek V4 is now generally available...",
      "site_name": "Example News",
      "site_icon": "https://example.com/favicon.ico",
      "date": "2026-06-01T00:00:00+00:00",
      "authority": 3
    }
  ]
}

results の各項目には以下が含まれます。

---

Fetch API​

リクエスト​

https://api.deepseek.com/v1/tools/fetch \
  -H "Authorization: Bearer <DeepSeek API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article"
  }'

import requests
response = requests.post(
    "https://api.deepseek.com/v1/tools/fetch",
    headers={
        "Authorization": "Bearer <DeepSeek API Key>",
    },
    json={"url": "https://example.com/article"},
)
response.raise_for_status()
page = response.json()
print(page["title"])
print(page["content"])

リクエストフィールド:

レスポンス​

{
  "title": "Example article",
  "content": "# Example article\n\nArticle content."
}

フェッチは、ターゲットサイトの可用性とアクセスポリシーの対象となります。

---

エラー​

エラーはOpenAI互換のエラー形式に従います。param フィールドは常に null です。

{
  "error": {
    "message": "'count' must be between 1 and 50",
    "type": "invalid_request_error",
    "param": null,
    "code": "invalid_request_error"
  }
}

SearchとFetchは読み取り専用です。HTTP 408、429、または5xxエラーの場合は、待ってから再試行してください。HTTP 402の場合は、アカウントにチャージしてから再試行してください。他の4xxエラーは、リクエストを変更せずに再試行しないでください。

---

請求​

SearchとFetchは、トークン数や返される結果の数ではなく、成功したリクエストごとに課金されます。

リクエストは、HTTP 200を返し、結果を生成した場合（Searchは空でない results 配列を返す必要があり、Fetchはページコンテンツを返す必要があります）にのみ課金対象となります。失敗したリクエスト、空の検索結果、タイムアウトは課金されません。count は返される結果の数を制御するだけで、リクエストあたりの価格には影響しません。

注意: DeepSeek Harness、Claude Code、またはCodexを通じてDeepSeek APIを使用する場合、サーバーサイドのツールコールは既にSearchおよびFetch APIにヒットしています。これらのコールは現在無料です。リクエストあたりの課金は、北京時間2026年11月1日午前0時に開始されます。

---

レート制限​

アカウントごとに、SearchとFetchは独立して制限され、一方へのトラフィックは他方のクォータを消費しません。

QPS（Requests Per Second）制限は、どのAPIキーが使用されているかに関わらず、アカウントレベルで計算され、モデルの同時実行制限とは別です。アカウントレベルのQPS制限を超えるリクエストはHTTP 429を受け取ります。アカウントレベルの制限に加えて、FetchはドメインごとのQPS制限も対象となり、その制限を超えるリクエストもHTTP 429を受け取ります。