Context API haalt de volledige context uit elke webpagina
Gebruik de Perplexity Context API om AI-agents schone Markdown, links en relevante passages te geven uit gecachete of live webpagina's.

Wanneer iemand een chatbot een vraag stelt, moet een AI-agent mogelijk meerdere webpagina's lezen om die te beantwoorden. Standaardzoekresultaten geven vaak alleen fragmenten. Een pagina rechtstreeks ophalen kan ruwe HTML opleveren, vol navigatie, cookiebanners en advertenties. Agents hebben de context van de pagina nodig in een formaat dat een model kan gebruiken, terwijl ontwikkelaars moeten kunnen bepalen hoe actueel die context moet zijn.
Vandaag lanceren we de Perplexity Context API, die tot 10 URL's leest en per pagina schone markdown, HTML, links en querygebaseerde fragmenten retourneert. De informatie komt uit de uitgebreide webindex van Perplexity of wordt live opgehaald. Agents kunnen per verzoek aangeven hoe actueel de gegevens moeten zijn en de bron van elk resultaat valideren.
Context API ondersteunt diverse formaten
Agents kunnen een verzoek indienen door een lijst met URL's op te geven en de uitvoerformaten te specificeren. De API retourneert voor elke URL een resultaat, in dezelfde volgorde.
Context API ondersteunt diverse responsformaten:
- Markdown: De inhoud van de pagina als schone Markdown, klaar om in de context van een model te plaatsen.
- HTML: De HTML van de pagina, voor applicaties die zelf de parsing uitvoeren.
- Links: De links op de pagina als absolute URL's, zonder duplicaten en in paginavolgorde, zodat een agent kan bepalen waar die vervolgens naartoe gaat.
- Fragmenten: De passages van de pagina die het meest relevant zijn voor een opgegeven query, binnen de tokenlimiet die de ontwikkelaar per pagina instelt.
Context API selecteert uit elke pagina passages die relevant zijn voor de query, in plaats van een samenvatting te genereren. Zo krijgt het model de oorspronkelijke formulering van de pagina, maar alleen de geselecteerde passages, waardoor er minder tekst te verwerken is.
Elk geslaagd resultaat bevat ook metadata zoals de titel, beschrijving, taal, auteur en publicatiedatum, plus de Open Graph-tags van de pagina. Om de Markdown op te bouwen, splitst de Context API een pagina op in blokken en beoordeelt een model elk blok als hoofdcontent of boilerplate. Alleen de contentblokken blijven behouden.
Essentieel voor taken waarvoor het volledige beeld nodig is
Een relevante pagina vinden is niet altijd genoeg om een taak af te ronden. Met Context API kunnen agents de content die ze nodig hebben ophalen van geselecteerde URL's om complexe taken uit te voeren.
- Een API-integratie implementeren: Een zoekresultaat kan naar de juiste documentatie verwijzen zonder de vereiste parameters, authenticatie-instructies of foutgevallen te bevatten. Context API kan een codeeragent helpen de documentatie en API-referenties op te halen om op basis van die details een integratie te schrijven.
- Actuele prijzen vergelijken: Een vermelde prijs kan afhangen van gebruikslimieten, factuurvoorwaarden of toelatingsvoorwaarden die in een zoekfragment ontbreken. Een agent kan geselecteerde prijspagina's live laten ophalen en die voorwaarden lezen voordat er een vergelijking wordt gemaakt.
- Beleidsvragen beantwoorden: Een fragment uit een retourbeleid kan de standaard retourtermijn vermelden, maar uitzonderingen voor bepaalde producten of regio's weglaten. Een supportagent kan de beleidspagina ophalen, zodat het antwoord rekening houdt met die uitzonderingen.
- Onderzoek over meerdere bronnen: Een zoekfragment kan een bevinding naar voren brengen zonder de methodologie, kanttekeningen of de bredere argumentatie. Een onderzoeksagent kan de geselecteerde artikelen en rapporten ophalen en vervolgens het bewijs vergelijken, in plaats van alleen op fragmenten te vertrouwen.
Bepaal de actualiteit en verwerk URL's betrouwbaar
Standaard controleert de Context API eerst de webindex van Perplexity op een kopie van de pagina die in de afgelopen twee dagen is opgehaald. Is die er niet, dan haalt de API de pagina live op. Ontwikkelaars kunnen max_age_seconds op 0 zetten om altijd de live pagina's te lezen, bijvoorbeeld voor prijzen, scores en het laatste nieuws. Voor referentiemateriaal dat zelden verandert, kunnen ze de waarde verhogen. Zet cache_only op true voor workloads die nooit een live verzoek mogen activeren.
Elk resultaat legt vast of de content afkomstig is van een opgeslagen kopie of live is opgehaald, en wanneer die is opgehaald.
URL's in een verzoek worden parallel opgehaald, elk met een eigen tijdsbudget en een eigen status. Eén trage of defecte pagina laat de andere niet mislukken. De status geeft aan wat er met elke URL is gebeurd, zodat een agent alleen de pagina's met een time-out opnieuw kan proberen en de rest kan behouden.
Context API levert bruikbare, volledige content
We hebben de Context API vergeleken met Firecrawl, Exa, Parallel, Keenable en Context.dev op 1.000 URL's, gesampled uit echte ophaalverzoeken van agents. De set omvat 715 sites, waaronder overheids- en academische bronnen en niet-Engelstalige pagina's. Vervolgens beoordeelde een apart beoordelaarsmodel de uitvoer, zonder te weten welke aanbieder welke uitvoer had geproduceerd.
De grafiek meet de prestaties op drie criteria:
- Bruikbaar: Het aandeel URL's dat de echte content van de pagina opleverde, en geen foutpagina of leeg resultaat.
- Feitenrecall: De beoordelaar verzamelt de belangrijkste feiten die bij alle aanbieders op een pagina zijn gevonden, en controleert vervolgens welke daarvan in elke uitvoer staan. Een mislukte ophaalactie scoort nul.
- Inhoudsprecisie: Het aandeel van de geretourneerde tekst dat uit pagina-inhoud bestaat, en niet uit cookiemeldingen, navigatie of advertenties, gemiddeld over alle URL’s. Een mislukte ophaalpoging scoort nul.
In deze evaluatie leverde de Context API bruikbare inhoud op voor 92,3% van de URL’s, achterhaalde hij 87,9% van de belangrijkste feiten en behaalde hij een score van 80,3% op inhoudsprecisie.
Prijzen
Context API kost $ 1 per 1.000 opgehaalde URL's. Ontwikkelaars betalen voor elke URL die ok retourneert. URL's die mislukken, worden niet gefactureerd.
Aan de slag
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"]
}'Elk resultaat bevat de Markdown van de pagina, de passages die overeenkomen met de query, de metadata van de pagina en een status. Controleer de status van elk resultaat voordat je de content gebruikt.
Lees de documentatie van Context API of bekijk de API-referentie.