Die Context API extrahiert den vollständigen Kontext aus jeder Webseite

Mit der Perplexity Context API erhalten KI-Agenten sauberes Markdown, Links und relevante Passagen aus zwischengespeicherten oder live abgerufenen Webseiten.

Context API artwork with a luminous mineral cross-section and geometric lines.

Wenn jemand einem Chatbot eine Frage stellt, muss ein KI-Agent unter Umständen mehrere Webseiten lesen, um sie zu beantworten. Standardsuchergebnisse liefern oft nur Snippets. Wird eine Seite direkt abgerufen, kann rohes HTML zurückkommen, das voller Navigation, Cookie-Banner und Werbung ist. Agenten benötigen den Kontext der Seite in einem Format, mit dem ein Modell arbeiten kann, während Entwickler eine Möglichkeit brauchen, festzulegen, wie aktuell dieser Kontext sein muss.

Heute führen wir die Perplexity Context API ein, die bis zu 10 URLs liest und für jede Seite sauberes Markdown, HTML, Links und abfragebasierte Snippets zurückgibt. Die Informationen stammen aus dem umfangreichen Webindex von Perplexity oder aus einem Live-Abruf. Agenten können für jede Anfrage die gewünschte Aktualität festlegen und die Quelle jedes Ergebnisses überprüfen.

Die Context API unterstützt eine Vielzahl von Formaten

Agenten können eine Anfrage starten, indem sie eine Liste von URLs übergeben und die Ausgabeformate angeben. Die API gibt für jede URL ein Ergebnis in derselben Reihenfolge zurück.

Die Context API unterstützt eine Vielzahl von Antwortformaten:

  • Markdown: Der Seiteninhalt als sauberes Markdown, bereit für den Kontext eines Modells.
  • HTML: Das HTML der Seite für Anwendungen, die ihr eigenes Parsing durchführen.
  • Links: Die Links auf der Seite als absolute URLs, ohne Duplikate und in der Reihenfolge auf der Seite, damit ein Agent entscheiden kann, wohin er als Nächstes geht.
  • Snippets: Die für eine angegebene Abfrage relevantesten Passagen der Seite, innerhalb des vom Entwickler für jede Seite festgelegten Token-Limits.

Die Context API wählt aus jeder Seite die für die Abfrage relevanten Passagen aus, anstatt eine Zusammenfassung zu generieren. Dadurch erhält das Modell den Originalwortlaut der Seite, aber nur die ausgewählten Passagen, sodass weniger Text verarbeitet werden muss.

Jedes erfolgreiche Ergebnis enthält außerdem Metadaten wie Titel, Beschreibung, Sprache, Autor und Veröffentlichungsdatum sowie die Open-Graph-Tags der Seite. Um das Markdown zu erstellen, zerlegt die Context API eine Seite in Blöcke, und ein Modell bewertet jeden Block als Hauptinhalt oder Boilerplate. Nur die Inhaltsblöcke bleiben erhalten.

Unverzichtbar für Aufgaben, die das Gesamtbild erfordern

Eine relevante Seite zu finden, reicht nicht immer aus, um eine Aufgabe zu erledigen. Mit der Context API können Agenten die benötigten Inhalte von ausgewählten URLs abrufen, um komplexe Aufgaben zu bewältigen.

  • Eine API-Integration implementieren: Ein Suchergebnis verweist möglicherweise auf die richtige Dokumentation, ohne die erforderlichen Parameter, Anweisungen zur Authentifizierung oder Fehlerfälle zu enthalten. Die Context API kann einem Coding-Agenten helfen, die Dokumentation und API-Referenzen abzurufen, um auf Grundlage dieser Details eine Integration zu schreiben.
  • Aktuelle Preise vergleichen: Ein angegebener Preis kann von Nutzungslimits, Abrechnungsbedingungen oder Teilnahmevoraussetzungen abhängen, die in einem Suchauszug fehlen. Ein Agent kann einen Live-Abruf ausgewählter Preisseiten anfordern und diese Bedingungen lesen, bevor er einen Vergleich anstellt.
  • Fragen zu Richtlinien beantworten: Ein Auszug aus einer Rückgaberichtlinie nennt möglicherweise die reguläre Rückgabefrist, lässt aber Ausnahmen für bestimmte Produkte oder Regionen weg. Ein Support-Agent kann die Seite mit der Richtlinie abrufen, damit seine Antwort diese Ausnahmen berücksichtigt.
  • Recherche über mehrere Quellen hinweg: Ein Suchauszug kann einen Befund aufzeigen, ohne die Methodik, Einschränkungen oder die zugehörige Argumentation zu liefern. Ein Recherche-Agent kann die ausgewählten Artikel und Berichte abrufen und anschließend die Belege vergleichen, anstatt sich allein auf Auszüge zu verlassen.

Aktualität steuern und URLs zuverlässig verarbeiten

Standardmäßig prüft die Context API zunächst, ob der Webindex von Perplexity eine Kopie der Seite enthält, die innerhalb der letzten zwei Tage abgerufen wurde. Ist das nicht der Fall, ruft sie die Seite live ab. Entwickler können max_age_seconds auf 0 setzen, um bei Preisen, Spielständen und Eilmeldungen stets die Live-Seiten zu lesen. Für Referenzmaterial, das sich selten ändert, können sie den Wert erhöhen. Für Workloads, die niemals eine Live-Anfrage auslösen sollen, wird cache_only auf true gesetzt.

Jedes Ergebnis hält fest, ob der Inhalt aus einer gespeicherten Kopie oder einem Live-Abruf stammt und wann er abgerufen wurde.

URLs in einer Anfrage werden parallel abgerufen, jede mit eigenem Zeitbudget und eigenem Status. Eine langsame oder fehlerhafte Seite führt nicht dazu, dass die anderen fehlschlagen. Der Status zeigt, was mit jeder URL passiert ist, sodass ein Agent nur die Seiten mit Zeitüberschreitung erneut abrufen und den Rest behalten kann.

Die Context API liefert brauchbare, vollständige Inhalte

Wir haben die Context API mit Firecrawl, Exa, Parallel, Keenable und Context.dev an 1.000 URLs verglichen, die als Stichprobe aus echten Abrufanfragen von Agenten gezogen wurden. Die Stichprobe umfasst 715 Websites, darunter Quellen von Behörden und Hochschulen sowie nicht englischsprachige Seiten. Ein separates Bewertungsmodell beurteilte anschließend die Ausgaben, ohne zu wissen, welcher Anbieter welche Ausgabe erstellt hatte.

Das Diagramm misst die Leistung anhand von drei Kriterien:

  • Brauchbar: Der Anteil der URLs, für die der tatsächliche Inhalt der Seite zurückgegeben wurde, statt einer Fehlerseite oder eines leeren Ergebnisses.
  • Faktenabdeckung: Das Bewertungsmodell sammelt die wichtigsten Fakten, die über alle Anbieter hinweg auf einer Seite gefunden wurden, und prüft dann, welche davon in jeder Ausgabe enthalten sind. Ein fehlgeschlagener Abruf erhält null Punkte.
  • Inhaltspräzision: Der Anteil des zurückgegebenen Textes, der tatsächlich Seiteninhalt ist und nicht aus Cookie-Hinweisen, Navigation oder Werbung besteht, gemittelt über alle URLs. Ein fehlgeschlagener Abruf wird mit null bewertet.

In dieser Evaluierung lieferte die Context API für 92,3 % der URLs verwertbare Inhalte, erfasste 87,9 % der Kernfakten und erreichte eine Inhaltspräzision von 80,3 %.

Preise

Die Context API kostet 1 $ pro 1.000 abgerufene URLs. Entwickler zahlen für jede URL, die den Status ok zurückgibt. Fehlgeschlagene URLs werden nicht berechnet.

Erste Schritte

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

Jedes Ergebnis enthält das Markdown der Seite, die zur Abfrage passenden Passagen, die Metadaten der Seite und einen Status. Vor der Verwendung des Inhalts sollte der Status jedes Ergebnisses geprüft werden.

Mehr dazu in der Dokumentation zur Context API oder in der API-Referenz.

  1. Orchestrator: Eine API für zuverlässige InferenzEntwickler17. Nov. 2026
  2. Wir stellen vor: die Monitor API von PerplexityEntwickler16. Nov. 2026