Search API と Fetch API の概要

Search API と Fetch API は、エージェントや RAG アプリケーションに対し、ライブの Web コンテンツへのアクセスを提供します。両 API は生の JSON API であり、DeepSeek API と同じ**ベアラ認証（Bearer 認証）**を使用します。

• Search API: クエリに対して Web ページを検索し、構造化された結果を返します。（DeepSeek の社内検索エンジンによる提供）
• Fetch API: 単一の Web ページを取得し、内容をMarkdown 形式で返します。

ベース URL:

https://api.deepseek.com

エンドポイント

/v1/tools/search

/v1/tools/fetch

詳細なスキーマについては公式リファレンスを参照してください。

認証

すべてのリクエストにおいて、以下のヘッダーを送信してください。

Authorization

Bearer <DeepSeek API Key>

Content-Type

application/json

リクエスト例

cURL (Search)

curl 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
    }'

Python (requests)

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(f"Title: {result['title']}")
    print(f"URL: {result['url']}")
    print(f"Summary: {result['summary']}\n")

Search API の詳細

リクエストパラメータ

query

count

10

ori_question

localization

""

need_content

false

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

検索演算子

クエリに以下の演算子を組み合わせて使用できます。複数の演算子は

OR

site:

site:DeepSeek

-site:

-site:example.com

-

-advertisement

"..."

-"release notes"

"..."

"exact phrase"

lang:

lang:zh,en

after:

after:2025-01-01

before:

before:2026-06-01

演算子使用例

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

レスポンス形式

成功（HTTP 200）時、

results

{}

rerank_score

title

url

snippet

summary

content

site_name

site_icon

date

authority

Fetch API の詳細

リクエストパラメータ

url

リクエスト例

cURL

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

Python

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"])  # Markdown 形式で取得

レスポンス形式

title

content

注意: Fetch は対象サイトの利用可能性とアクセスポリシーにより制限されます。

エラーハンドリング

エラーは OpenAI 互換形式に従います。

param

null

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

HTTP ステータスコード一覧

400

401

402

403

404

408

413

429

500

504

再試行ガイドライン

• 読み取り専用 API です。
• HTTP 408, 429, 5xx: 待機後、再試行してください。
• HTTP 402: 口座精算を完了させるまで再試行不可。
• 他 4xx エラー: リクエスト内容を変更しない限り再試行しないでください。

請求方法

トークン数や結果数ではなく、成功したリクエストごとに課金されます（空の結果や失敗は非課金）。

• 課金条件: HTTP 200 を返し、有効な結果（Search: 非空アレイ / Fetch: コンテンツあり）を生成した場合のみ。
• count パラメータ: 返す結果の数を制御するだけで、1 リクエストあたりの価格には影響しません。

重要: DeepSeek Harness, Claude Code, Codex を通じて API を使用する場合は、サーバーサイドでのツール呼び出しが無料で利用可能です（課金開始：2026 年 11 月 1 日 北京時間 00:00 から）。

レート制限

各アカウントに対し、Search と Fetch は独立して制限されます。

制限の詳細

• アカウントレベル:どの API キーを使用したかに関わらず合計で計算され、超過時は HTTP 429 が返ります。
• ドメイン別: Fetch はさらに「ドメイン別の QPS リミット」も適用され、超過時も HTTP 429 が返されます。