DeepSeek Search API: kostenloses Zeitfenster, Preise, Fetch API und Stichtag am 31. Oktober

Kurze Antwort: Die DeepSeek Search API ist nur innerhalb von drei Coding-Tools kostenlos, und nur bis zum 31. Oktober 2026 um 16:00 UTC. Such- und Fetch-Aufrufe, die Claude Code, Codex oder DeepSeek Harness serverseitig ausführen, kosten bis dahin nichts. Danach – und für jeden direkten Aufruf der Endpunkte – zahlen Sie $0.75 pro 1.000 erfolgreiche Anfragen pro Endpunkt. Fehlgeschlagene Aufrufe, leere Ergebnisse und Timeouts werden nie berechnet.

DeepSeek hat seine Search- und Fetch-APIs am 17. Oktober 2026 zeitgleich mit dem Release von DeepSeek-V4.1-Flash-1017 für alle geöffnet. Sie liefern einem Agenten aktuelle Web-Ergebnisse für eine Suchanfrage und eine saubere Markdown-Kopie jeder Seite. Dieser Leitfaden behandelt, was kostenlos ist, was es nach Ablauf des Zeitfensters kostet, die Rate Limits, eine erste Anfrage und das Testen beider Endpunkte mit der Apidog CLI.

Jede Angabe unten stammt aus DeepSeeks Such- & Fetch-Leitfaden und der Preisseite, gelesen am 28. Oktober 2026.

Ist die DeepSeek Search API kostenlos?

Ja, mit zwei Einschränkungen: von wo aus Sie sie aufrufen und wann. In DeepSeeks Dokumentation heißt es, dass serverseitige Search- und Fetch-Aufrufe über DeepSeek Harness, Claude Code oder Codex „derzeit kostenlos“ sind. Die Abrechnung pro Anfrage für diese Aufrufe beginnt am 1. November 2026 um 00:00 Uhr UTC+8, also am 31. Oktober 2026 um 16:00 UTC.

Zwei Haken verhindern, dass dies ein wirklich kostenloser Weg ist:

1. Sie brauchen trotzdem einen aufgeladenen DeepSeek-API-Schlüssel. Das kostenlose Zeitfenster deckt die Suchaufrufe ab, nicht das Modell. Auf DeepSeeks Seite zur Claude-Code-Integration heißt es, dass das Zusammenfassen von Suchergebnissen zusätzliche LLM-Anfragen verursacht, und diese Tokens werden zu den normalen Modellpreisen abgerechnet.
2. Das Zeitfenster gilt nur für serverseitige Tool-Aufrufe. Die Dokumentation beschränkt es auf diese drei Tools. Wenn Ihr eigener Code die Endpunkte aufruft, zahlen Sie ab der ersten erfolgreichen Anfrage.

Wenn Sie eher ein kostenloses DeepSeek-Modell als eine kostenlose Suche suchen: Unser Leitfaden dazu, ob DeepSeek kostenlos ist, listet alle Wege auf, und DeepSeek-API-Schlüssel kostenlos behandelt den Schlüssel selbst.

Was die DeepSeek Search- und Fetch-APIs leisten

Die DeepSeek Search API nimmt eine Suchanfrage entgegen und liefert strukturierte Web-Ergebnisse: Titel, URL, Snippet, eine längere, auf das Modell ausgerichtete Zusammenfassung, ein optionales Feld mit dem Inhalt der ganzen Seite, einen Relevanz-Score und einen Autoritäts-Score. Die DeepSeek Fetch API nimmt eine URL entgegen und liefert den Titel dieser Seite und ihren Inhalt als Markdown. Zusammen geben sie einem Agenten Suche plus Lesen in zwei Aufrufen.

Ein Recherche-Agent sucht in der Regel einmal und ruft dann zwei oder drei Seiten ab, und jeder dieser Vorgänge ist nach Ablauf des Zeitfensters ein eigener kostenpflichtiger Aufruf. Die Suche unterstützt Operatoren: site:, -site:, "phrase", -term, lang:en,ja, after: und before:.

Sie können dies mit anderen Optionen in unserem Überblick über kostenlose Web-Such-APIs, die Claude Web Search API und die Perplexity Search API vergleichen.

DeepSeek Search API: Preise nach dem kostenlosen Zeitfenster

Sobald das Zeitfenster schließt, werden beide Endpunkte gleich abgerechnet:

Die Kosten werden von Ihrem DeepSeek-Guthaben abgezogen, und laut Preisseite wird zugeteiltes Guthaben vor aufgeladenem Guthaben verwendet, wenn Sie beides haben.

Eine kurze Rechnung für einen Recherche-Agenten, der 200 Aufgaben pro Tag ausführt, jede mit einer Suche und drei Fetches:

• 200 Suchen x $0.00075 = $0.15
• 600 Fetches x $0.00075 = $0.45
• Gesamt: $0.60 pro Tag, etwa $18 pro Monat, ohne Modell-Tokens

Da count den Preis nicht ändert, fordern Sie bis zu 50 Ergebnisse in einem einzigen Aufruf an, statt zu blättern. Auf der Modellseite kostet deepseek-flash $0.15 pro Million Input-Tokens (Cache-Miss, Off-Peak) und $0.60 pro Million Output-Tokens, zu Spitzenzeiten verdoppelt; siehe DeepSeek V4.1 Flash pricing.

Rate Limits der DeepSeek Search API

Einige Beiträge Dritter nennen ein Limit von 5 QPS. DeepSeeks eigener Leitfaden nennt andere Zahlen, und diese sollten Ihre Planungsgrundlage sein:

• Search: 100 Abfragen pro Sekunde
• Fetch: 25 Abfragen pro Sekunde, plus ein Limit pro Domain, dessen Wert nicht veröffentlicht wird

Die Limits gelten pro Konto, für alle Ihre API-Schlüssel und sind unabhängig von der Modell-Konkurrenz. Search und Fetch werden getrennt gemessen, sodass eine Serie von Fetches nicht Ihr Suchbudget aufbraucht. Bei Überschreitung wird HTTP 429 zurückgegeben.

Achten Sie auf das Fetch-Limit pro Domain: Ein Agent, der 20 Seiten von einer einzigen Doku-Website abruft, kann es schon deutlich unter 25 QPS erreichen. Verteilen Sie Fetches auf dieselbe Domain zeitlich und wiederholen Sie 429er mit Backoff.

Endpunkte und Ihr erster Aufruf der DeepSeek Search API

Beide Endpunkte sind POST, verwenden einen Bearer-Token und nehmen JSON entgegen:

• Search: https://api.deepseek.com/v1/tools/search
• Fetch: https://api.deepseek.com/v1/tools/fetch

Felder der Suchanfrage

Eine Suchanfrage, entnommen aus der Dokumentation:

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

Jeder Eintrag im results-Array enthält title, url, snippet, summary, content, site_name, site_icon, date (UTC RFC 3339 oder null), rerank_score und authority. Filtern Sie vor dem Abruf nach zwei davon:

• rerank_score reicht von 0 bis 3. DeepSeek betrachtet 1,5 oder höher als hohe Qualität.
• authority reicht von 0 bis 4, wobei -1 für unbekannt steht. 3 oder höher bedeutet eine hochgradig autoritative Quelle.

Eine Fetch-Anfrage nimmt ein Feld entgegen, url (HTTP oder HTTPS, bis zu 8.192 Zeichen, ohne eingebetteten Benutzernamen oder Passwort):

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

Sie liefert title (kann leer sein) und content als Markdown.

Fehler, die Ihnen begegnen werden

Der Fehler-Body folgt dem OpenAI-Format: message, type, param (immer null) und code.

Search aus Claude Code oder Codex nutzen vs. direkt aufrufen

Das kostenlose Zeitfenster gilt nur, wenn ein Coding-Tool den Aufruf für Sie übernimmt, das Setup entscheidet also über die Rechnung.

Claude Code. Richten Sie Claude Code auf DeepSeeks Anthropic-kompatiblen Endpunkt aus, und DeepSeeks API führt das Web-Search-Tool serverseitig aus. Die zentralen Variablen von DeepSeeks Seite:

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-flash[1m]

Kopieren Sie den vollständigen Block, der noch einige weitere Modellvariablen setzt, von DeepSeeks Seite.

Codex. Die in Codex integrierte Websuche funktioniert laut DeepSeeks Codex-Integrationsseite nur mit deepseek-v4-pro. Das Setup-Skript deaktiviert die Websuche standardmäßig, setzen Sie daher diese beiden Zeilen in ~/.codex/config.toml und starten Sie neu:

model = "deepseek-v4-pro"
web_search = "live"

Der Haken: deepseek-v4-pro kostet pro Token mehr als deepseek-flash.

Direkte Aufrufe. Rufen Sie die Endpunkte selbst auf, wenn Sie Ihren eigenen Agenten bauen oder count, need_content und die Operatoren selbst unter Kontrolle haben möchten. Sie zahlen ab dem ersten erfolgreichen Aufruf. Wenn Sie nur einen Agenten möchten, der während des Programmierens nachschlägt, nutzen Sie Claude Code oder Codex innerhalb des Zeitfensters.

Lassen Sie Ihren Coding-Agenten die DeepSeek Search API mit der Apidog CLI testen

Bevor Sie Search und Fetch in ein Produkt einbinden, sollten Sie belegen, dass Authentifizierung, Antwortformat und Fehler sich wie dokumentiert verhalten. Ihr Coding-Agent kann diese Prüfungen mit der Apidog CLI erstellen und ausführen, sodass die Tests in einem Projekt liegen, das Ihr Team in der CI erneut ausführt.

Einmalig einrichten:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted

Geben Sie dann Claude Code, Codex oder welchem Agenten Sie auch immer verwenden, einen Prompt:

In Apidog project <projectId>, add the DeepSeek endpoints POST /v1/tools/search
and POST /v1/tools/fetch with base URL https://api.deepseek.com and bearer auth
from the DEEPSEEK_API_KEY variable. Create test cases that assert: search returns
200 with a results array whose rerank_score values are between 0 and 3; fetch on
https://example.com returns 200 with non-empty content; a bad key returns 401.
Run them against the deepseek environment and summarize any failures.

Der Agent liest jedes Payload-Schema, validiert dessen JSON und schreibt dann die Tests und führt sie aus:

apidog environment create deepseek --project <projectId> --base-url https://api.deepseek.com
apidog cli-schema get endpoint-create
apidog cli-schema validate endpoint-create --file search-endpoint.json
apidog endpoint create --project <projectId> --file search-endpoint.json
apidog cli-schema get test-case-create
apidog test-case create --project <projectId> --file search-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json

Jeder vollständige Durchlauf erzeugt nach Ablauf des Zeitfensters zwei kostenpflichtige Aufrufe (eine Suche, ein Fetch), kostet also $0.0015. Die 401-Prüfung kostet nichts, weil fehlgeschlagene Anfragen nicht abgerechnet werden. Dieselbe Zeile apidog run ... -r junit lässt sich in eine Pipeline einfügen, wie unter Apidog CLI in CI/CD ausführen gezeigt. Wenn Claude Code Ihr Agent ist, führt Sie Apidog CLI in Claude Code durch die Installation des Skills.

Der kostenlose Tarif von Apidog deckt bis zu 4 Nutzer ab, sodass ein kleines Team das Projekt und seinen Testverlauf gemeinsam nutzen kann.

FAQ

Ist die DeepSeek Search API nach dem 31. Oktober kostenlos? Nein. Ab 16:00 UTC am 31. Oktober 2026 kosten Search- und Fetch-Aufrufe über Claude Code, Codex und DeepSeek Harness $0.75 pro 1.000 erfolgreiche Anfragen – genauso viel wie direkte Aufrufe.

Ist die DeepSeek Fetch API kostenlos? Nur zu denselben Bedingungen wie Search: kostenlos, wenn Claude Code, Codex oder DeepSeek Harness sie vor dem Stichtag serverseitig aufrufen, danach $0.75 pro 1.000 erfolgreiche Anfragen.

Brauche ich einen DeepSeek-API-Schlüssel, um die kostenlose Suche in Claude Code zu nutzen? Ja. Claude Code muss mit einem DeepSeek-API-Schlüssel über https://api.deepseek.com/anthropic laufen, und die Modell-Tokens, die es für das Zusammenfassen von Ergebnissen verbraucht, werden normal abgerechnet.

Wie hoch ist das Rate Limit der DeepSeek Search API? DeepSeeks Leitfaden nennt 100 QPS für Search und 25 QPS für Fetch pro Konto, plus ein nicht veröffentlichtes Limit pro Domain bei Fetch. Bei Überschreitung wird HTTP 429 zurückgegeben.

Wird mir etwas berechnet, wenn eine Suche nichts liefert? Nein. Leere Ergebnisse, fehlgeschlagene Anfragen und Timeouts werden nicht abgerechnet. Search wird nur bei HTTP 200 mit einem nicht leeren results-Array berechnet.

Kostet es mehr, wenn ich mehr Ergebnisse anfordere? Nein. Das Feld count (1 bis 50) ändert den Preis nicht, eine Suche mit 50 Ergebnissen kostet also dasselbe wie eine mit 5 Ergebnissen.