Context API extraherar hela kontexten från valfri webbsida

Använd Perplexity Context API för att ge AI-agenter ren Markdown, länkar och relevanta avsnitt från cachelagrade eller livehämtade webbsidor.

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

När någon ställer en fråga till en chattbot kan en AI-agent behöva läsa flera webbsidor för att kunna svara. Vanliga sökresultat returnerar ofta bara korta utdrag. Om man hämtar en sida direkt kan man få rå HTML full av navigering, cookiebanners och annonser. Agenter behöver sidans kontext i ett format som en modell kan använda, medan utvecklare behöver ett sätt att styra hur färsk den kontexten måste vara.

I dag lanserar vi Perplexity Context API, som läser upp till 10 URL:er och returnerar ren Markdown, HTML, länkar och frågebaserade utdrag för varje sida. Informationen kommer från Perplexitys omfattande webbindex eller från en livehämtning. Agenter kan ange hur färsk varje förfrågan ska vara och verifiera källan för varje resultat.

Context API stöder en mängd olika format

Agenter kan initiera en förfrågan genom att ange en lista med URL:er och välja utdataformat. API:et returnerar ett resultat för varje URL i samma ordning.

Context API stöder en mängd olika svarsformat:

  • Markdown: Sidans innehåll som ren Markdown, redo att placeras i en modells kontext.
  • HTML: Sidans HTML, för applikationer som sköter sin egen parsning.
  • Länkar: Länkarna på sidan som absoluta URL:er, utan dubbletter och i den ordning de förekommer på sidan, så att en agent kan avgöra vart den ska gå härnäst.
  • Utdrag: De avsnitt på sidan som är mest relevanta för en angiven fråga, inom den tokengräns som utvecklaren har satt för varje sida.

Context API väljer ut de avsnitt på varje sida som är relevanta för frågan i stället för att generera en sammanfattning. Det innebär att modellen får sidans ursprungliga formuleringar, men bara de utvalda avsnitten, så det blir mindre text att bearbeta.

Varje lyckat resultat innehåller även metadata som titel, beskrivning, språk, författare och publiceringsdatum, samt sidans Open Graph-taggar. För att skapa Markdown-versionen delar Context API upp sidan i block, och en modell bedömer om varje block är huvudinnehåll eller standardtext. Endast innehållsblocken behålls.

Oumbärligt för uppgifter som kräver helhetsbilden

Att hitta en relevant sida räcker inte alltid för att slutföra ett jobb. Med Context API kan agenter hämta det innehåll de behöver från utvalda URL:er för att slutföra komplexa uppgifter.

  • Implementera en API-integration: Ett sökresultat kan peka ut rätt dokumentation utan att innehålla de parametrar, autentiseringsinstruktioner eller felfall som krävs. Context API kan hjälpa en kodningsagent att hämta dokumentationen och API-referenserna så att den kan skriva en integration utifrån de detaljerna.
  • Jämföra aktuella priser: Ett angivet pris kan bero på användningsgränser, faktureringsvillkor eller behörighetskrav som saknas i ett utdrag från en sökning. En agent kan begära en livehämtning av utvalda prissidor och läsa de villkoren innan den gör en jämförelse.
  • Besvara frågor om policyer: Ett utdrag ur en returpolicy kan ange den vanliga returperioden men utelämna undantag för vissa produkter eller regioner. En supportagent kan hämta policysidan så att svaret tar hänsyn till de undantagen.
  • Forska i flera källor: Ett utdrag från en sökning kan lyfta fram ett rön utan metodiken, förbehållen eller den omgivande argumentationen. En forskningsagent kan hämta de utvalda artiklarna och rapporterna och sedan jämföra underlaget i stället för att enbart förlita sig på utdrag.

Styr hur färskt innehållet är och hantera URL:er tillförlitligt

Som standard kontrollerar Context API först om Perplexitys webbindex har en kopia av sidan som hämtats under de senaste två dagarna. Om det inte finns någon hämtas sidan live. Utvecklare kan ändra max_age_seconds till 0 för att alltid läsa sidorna live, till exempel för priser, matchresultat och senaste nytt. För referensmaterial som sällan ändras kan de höja värdet. Sätt cache_only till true för arbetslaster som aldrig ska utlösa en liveförfrågan.

Varje resultat anger om innehållet kom från en lagrad kopia eller en livehämtning, och när det hämtades.

URL:erna i en förfrågan hämtas parallellt, var och en med sin egen tidsbudget och sin egen status. En långsam eller trasig sida gör inte att de andra misslyckas. Statusen visar vad som hände med varje URL, så att en agent kan göra om försöket för enbart de sidor som fick timeout och behålla resten.

Context API returnerar användbart och komplett innehåll

Vi testade Context API mot Firecrawl, Exa, Parallel, Keenable och Context.dev på 1 000 URL:er som valts ut från verkliga hämtningsförfrågningar från agenter. Urvalet omfattar 715 webbplatser och innehåller myndighetskällor, akademiska källor och sidor på andra språk än engelska. En separat bedömarmodell poängsatte sedan resultaten utan att veta vilken leverantör som hade tagit fram vart och ett av dem.

Diagrammet mäter prestanda utifrån tre kriterier:

  • Användbarhet: Andelen URL:er som returnerade sidans faktiska innehåll, inte en felsida eller ett tomt resultat.
  • Faktatäckning: Bedömaren samlar in de viktigaste fakta som hittats på en sida hos samtliga leverantörer och kontrollerar sedan vilka av dem som finns med i varje resultat. En misslyckad hämtning ger noll poäng.
  • Innehållsprecision: Andelen returnerad text som är sidinnehåll och inte cookiemeddelanden, navigering eller annonser, i genomsnitt över alla URL:er. En misslyckad hämtning ger noll poäng.

I den här utvärderingen returnerade Context API användbart innehåll för 92,3 % av URL:erna, återfann 87,9 % av de viktigaste fakta och nådde 80,3 % i innehållsprecision.

Priser

Context API kostar 1 USD per 1 000 hämtade URL:er. Utvecklare betalar för varje URL som returnerar ok. URL:er som misslyckas debiteras inte.

Kom igång

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

Varje resultat returneras med sidans Markdown, de avsnitt som matchar frågan, sidans metadata och en status. Kontrollera statusen för varje resultat innan du använder innehållet.

Läs dokumentationen för Context API eller se API-referensen.

  1. Orchestrator: ett API för tillförlitlig inferensUtvecklare17 nov. 2026
  2. Vi presenterar Perplexitys Monitor APIUtvecklare16 nov. 2026