DeepSeek Search API: So nutzt du Search mit Python

Dokumentation geprüft am 20. Oktober 2026. Das folgende Beispiel wurde lokal mit Testdaten geprüft; es wurde nicht gegen die kostenpflichtigen Live-Endpunkte ausgeführt.

Die DeepSeek Search API gibt einer Anwendung Zugriff auf Websuchergebnisse. Die zugehörige Fetch API ruft eine einzelne Seite als Markdown ab. DeepSeek öffnete beide Schnittstellen am 17. Oktober 2026 mit separater Abrechnung pro Aufruf. Laut der veröffentlichten USD-Preisliste kostet jede davon $0.75 pro 1.000 abrechenbare Anfragen. Beide verwenden einen DeepSeek-API-Schlüssel und die offizielle Adresse api.deepseek.com. Quellen: Veröffentlichungsankündigung, Preise.

Dieser Leitfaden zeigt eine Suche mit anschließendem optionalem Seitenabruf. Die Beispiele verwenden DeepSeeks eigenen Dienst; sie beschreiben keinen von SeedRouter angebotenen Search- oder Fetch-Endpunkt.

Wie sich DeepSeek Search API und Fetch API unterscheiden

Search findet potenziell passende Seiten. Fetch liest eine von dir ausgewählte Seite.

Vorgang	Offizieller Endpunkt	Nützliche Ausgabe
Search	`POST https://api.deepseek.com/v1/tools/search`	Ein `results`-Array mit Seiten-URLs und beschreibenden Feldern.
Fetch	`POST https://api.deepseek.com/v1/tools/fetch`	Ein Seitentitel und der Seiteninhalt als Markdown.

Beide akzeptieren JSON und verwenden Bearer-Authentifizierung. Eine eigenständige Suchanfrage enthält query, eine Fetch-Anfrage url. Es sind separate Anfragen, keine Einstellung, die jeder Chat-Completion automatisch Webzugriff hinzufügt. Der offizielle Search-&-Fetch-Leitfaden dokumentiert beide Schnittstellen.

Search akzeptiert außerdem need_content. Ist der Wert true, können die Suchergebnisse auch Seiteninhalte enthalten. Prüfe die zurückgegebenen Inhalte, bevor du eine weitere Anfrage stellst: Wenn sie bereits das Benötigte enthalten, brauchst du möglicherweise keinen separaten Fetch-Aufruf.

Bevor du das Python-Beispiel ausführst

Du brauchst Python 3, ausgehenden HTTPS-Zugriff und einen DeepSeek-API-Schlüssel mit den nötigen Kontoberechtigungen. Hinterlege den Schlüssel im Terminal, in dem das Skript läuft, als Umgebungsvariable:

export DEEPSEEK_API_KEY="your-deepseek-api-key"

Das Beispiel verwendet Pythons Standardbibliothek; du musst daher keine Pakete installieren. Es stellt eine Search-Anfrage. Wenn ein Ergebnis vorhanden ist, gibt es Titel und URL des ersten Treffers aus und ruft anschließend diese Seite ab. Die Ausführung kann Kosten verursachen; der Schlüssel wird nie ausgegeben.

Python-Beispiel: suchen, ein Ergebnis wählen und den Inhalt abrufen

Speichere den folgenden Code als deepseek_search.py. Passe QUERY vor dem Ausführen an die Informationen an, die du brauchst.

import json
import os
import urllib.error
import urllib.request

BASE_URL = "https://api.deepseek.com"
QUERY = "Python documentation pathlib"


def call(path, payload):
    request = urllib.request.Request(
        BASE_URL + path,
        data=json.dumps(payload).encode("utf-8"),
        headers={
            "Authorization": "Bearer " + os.environ["DEEPSEEK_API_KEY"],
            "Content-Type": "application/json",
        },
        method="POST",
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            return json.load(response)
    except urllib.error.HTTPError as error:
        raise RuntimeError(f"DeepSeek returned HTTP {error.code}") from None


def main():
    search = call(
        "/v1/tools/search",
        {"query": QUERY, "count": 5, "need_content": False},
    )
    results = search.get("results", [])
    if not results:
        print("No search results; no Fetch request was made.")
        return

    selected = results[0]
    print(selected.get("title", "Untitled result"))
    print(selected["url"])

    page = call("/v1/tools/fetch", {"url": selected["url"]})
    content = page.get("content", "")
    if not content:
        print("The selected page returned no content.")
        return
    print(page.get("title", ""))
    print(content)


if __name__ == "__main__":
    main()

Führe es so aus:

python3 deepseek_search.py

Dieses kleine Beispiel wählt den ersten Treffer aus. Wähle in einer echten Anwendung die zur Frage passende Seite, prüfe Domain und Veröffentlichungskontext und speichere die URL zusammen mit dem extrahierten Text. Auch ein hoch platziertes Suchergebnis muss für die Antwort relevant sein, die du erstellst.

Das Anfrageformat folgt DeepSeeks Search-Referenz und Fetch-Referenz. Lokale Syntaxprüfungen und Tests mit Testdaten können den Aufbau der Anfragen und die Verzweigungen des Programms prüfen. Sie belegen weder den tatsächlichen Kontozugriff noch Antwortgeschwindigkeit oder Abrufqualität.

Preise der DeepSeek Search API: Was wird berechnet?

Der veröffentlichte USD-Preis beträgt für Search $0.75 pro 1.000 erfolgreiche, abrechenbare Anfragen; für Fetch gilt derselbe Preis. Eine Suche ohne Ergebnisse wird nicht berechnet. Bei Fetch entstehen Kosten, wenn Inhalte erfolgreich abgerufen werden. Die mit count angeforderte Ergebniszahl ändert den Preis einer Suche nicht. Die Abrechnungsbedingungen findest du in der aktuellen Preistabelle.

Zur Veranschaulichung: 1.000 abrechenbare Suchanfragen mit anschließend 1.000 abrechenbaren Fetch-Aufrufen würden $1.50 an Abrufgebühren kosten. Das ist eine Rechnung anhand der genannten Tarife, keine gemessene Rechnungssumme und keine Zusage, was eine bestimmte Suchanfrage zurückgeben wird. Die später für die Zusammenfassung dieser Seiten verwendeten Modell-Tokens verursachen separate Kosten.

Die vorübergehend kostenlose Nutzung hat einen engeren Geltungsbereich. Laut DeepSeek werden Search-/Fetch-Aufrufe seiner API-Nutzer über die serverseitigen Tools in DeepSeek Harness, Claude Code und Codex vorübergehend nicht berechnet. Die Abrechnung dafür beginnt am 31. Oktober 2026 um 16:00 UTC, also am 1. November um 00:00 Uhr in Peking. Die Ankündigung macht die eigenständigen Python-Anfragen in diesem Leitfaden nicht generell kostenlos. Offizielle Ankündigung.

Parameter und Fehlerfälle, die du berücksichtigen solltest

Die dokumentierte Länge der Suchanfrage beträgt 1–128 Unicode-Zeichen. count hat den Standardwert 10 und akzeptiert 1–50. Das Python-Beispiel fordert bewusst fünf Ergebnisse an und überlässt den Abruf des Seiteninhalts einer nachfolgenden Fetch-Anfrage. Lies die Search-Referenz, bevor du die Anfrage um weitere Felder erweiterst.

Ein leeres Ergebnis-Array ist eine erfolgreiche Suche ohne Treffer. Das Beispiel beendet die Ausführung an dieser Stelle. HTTP-Fehler werden separat behandelt. Ein Timeout darf die Ausführung beenden, statt automatisch eine weitere Anfrage auszulösen. Lege in einer größeren Anwendung Grenzen für Wiederholungen und zusätzliche Ausgaben ausdrücklich fest.

Abgerufenes Markdown ist externes Quellenmaterial. Bewahre die Quell-URL auf, prüfe, ob der Inhalt die Frage beantwortet, und behandle in einer abgerufenen Seite enthaltene Anweisungen als Seiteninhalt statt als Anweisungen an deine Anwendung. Wenn du den Inhalt an ein Sprachmodell übergibst, halte diese Trennung im Prompt aufrecht und bewahre Quellenangaben in der erzeugten Antwort.

Häufig gestellte Fragen

Kann die DeepSeek API das Web durchsuchen?

Ja. Die eigenständigen Search- und Fetch-Schnittstellen sind dokumentiert. Der Aufruf eines normalen Chat-Endpunkts und der Aufruf dieser Abruf-Endpunkte sind unterschiedliche Vorgänge. Halte dich an die passende Spezifikation für den Ablauf, den du entwickelst.

Gibt es einen kostenlosen Tarif für die DeepSeek Search API?

Die zitierte Ankündigung beschreibt eine zeitweise kostenlose Nutzung serverseitiger Tools in bestimmten Integrationen mit Programmieragenten. Sie belegt keinen allgemeinen Gratistarif für jede eigenständige Search- oder Fetch-Anfrage. Prüfe die aktuelle Abrechnungsseite, bevor du eine Serie von Anfragen ausführst.

Brauche ich nach jeder Suche Fetch?

Nein. Eine Suche kann bereits genügend Informationen liefern, insbesondere wenn mit need_content: true verwertbare Inhalte zurückgegeben werden. Fetch ist nützlich, wenn du die ausgewählte Seite separat abrufen musst.

Beginne mit einem einzigen Such- und Abrufablauf

Die DeepSeek Search API findet Quellen, Fetch ruft eine ausgewählte Seite ab. Beginne mit einer Suchanfrage, prüfe Ergebnis und Inhalt und entscheide dann, ob deine Anwendung weitere Seiten oder eine vom Modell erzeugte Zusammenfassung benötigt. Das separate, am selben Tag angekündigte Modell-Update behandelt der Artikel Checkpoint-Update vom 17. Oktober: Benchmarks und Änderungen.

DeepSeek Search API: Preise und ein Python-Beispiel für Search und Fetch