Perplexity API gebruiken: complete handleiding met Python en JavaScript

Tutorials
maandag, 27 juli 2026 om 19:30
Een rakket die vliegt
Met de Perplexity API kun je actuele webzoekresultaten, antwoorden met citaties en verschillende AI-modellen in je eigen website, app, chatbot of bedrijfsproces verwerken.
De API is afzonderlijk van de gewone Perplexity-website. Een Pro-, Max- of Enterprise-abonnement geeft niet automatisch API-tegoed. Voor de API maak je een aparte omgeving aan en betaal je op basis van daadwerkelijk gebruik.
De huidige API-omgeving bestaat uit meerdere onderdelen:
  • Agent API voor AI-antwoorden, verschillende modelaanbieders en hulpmiddelen zoals websearch;
  • Search API voor ruwe gerangschikte zoekresultaten zonder samengesteld AI-antwoord;
  • Embeddings API voor semantisch zoeken en RAG;
  • Sonar API voor webgebaseerde chatantwoorden met citaties via een OpenAI-compatibele interface.
Wil je Perplexity als gewone gebruiker inzetten? Gebruik dan onze complete handleiding voor Perplexity AI. Dit artikel gaat uitsluitend over programmatische toegang voor ontwikkelaars.
De code, modellen en prijzen zijn gecontroleerd op 26 juli 2026.

Wat is de Perplexity API?

Een API is een technische verbinding waarmee software gecontroleerd opdrachten en gegevens kan uitwisselen. Met de Perplexity API stuur je vanuit je eigen programma een zoekvraag of instructie. Perplexity verwerkt de opdracht en stuurt een gestructureerd antwoord terug.
Daarmee kun je bijvoorbeeld:
  • een chatbot actuele webinformatie laten gebruiken;
  • nieuws, bedrijfsinformatie of productprijzen doorzoeken;
  • zoekresultaten in een eigen interface tonen;
  • antwoorden met bronnen genereren;
  • meerdere websites periodiek laten controleren;
  • documenten omzetten naar embeddings voor semantisch zoeken;
  • een eigen onderzoeks- of RAG-workflow bouwen;
  • modellen van verschillende aanbieders via één API benaderen.
De API is geen geautomatiseerde versie van je persoonlijke Perplexity-account. Sessies, Projects, je Pro-abonnement en de API hebben hun eigen functies, facturering en limieten.

Welke Perplexity API heb je nodig?

APIUitkomstBeste keuze voor
Agent APIGegenereerd AI-antwoord, eventueel met tools en citatiesAssistenten, agents en onderzoeksapps
Search APIRuwe zoekresultaten met URL, titel en fragmentEigen zoekinterface of zoekpipeline
Sonar APIWebgebaseerd chatantwoord met citatiesSnelle integratie via Chat Completions
Embeddings APINumerieke vectoren van tekstRAG, aanbevelingen en semantische zoekfuncties
De officiële API-quickstart adviseert de Agent API wanneer je een compleet antwoord met bronnen wilt. Kies de Search API wanneer je de resultaten zelf wilt verwerken en je eigen taalmodel, ranking of interface gebruikt.
Sonar blijft handig voor bestaande toepassingen die al met het OpenAI Chat Completions-formaat werken.

Wat kost de Perplexity API?

De API werkt met vooruitbetaalde credits en gebruikskosten. Een Perplexity-abonnement voor consumenten bevat geen gratis API-tegoed.
Volgens de officiële prijspagina gelden op de controledatum onder meer deze tarieven:
ProductBelangrijkste kosten
Search API5 dollar per 1.000 verzoeken
Sonar1 dollar per miljoen inputtokens en 1 dollar per miljoen outputtokens
Sonar Pro3 dollar per miljoen inputtokens en 15 dollar per miljoen outputtokens
Sonar Reasoning Pro2 dollar per miljoen inputtokens en 8 dollar per miljoen outputtokens
Sonar Deep Research2 dollar per miljoen inputtokens, 8 dollar per miljoen outputtokens en aanvullende kosten voor citatie-, redeneer- en zoekgebruik
Agent APIModelkosten plus eventuele kosten per gebruikt hulpmiddel
EmbeddingsAfhankelijk van model en aantal tokens
Bij Sonar, Sonar Pro en Sonar Reasoning Pro komt daar een bedrag per verzoek bij. Dat bedrag hangt af van de gekozen zoekcontext:
ModelLage contextMiddelgrote contextHoge context
Sonar$5 per 1.000$8 per 1.000$12 per 1.000
Sonar Pro$6 per 1.000$10 per 1.000$14 per 1.000
Sonar Reasoning Pro$6 per 1.000$10 per 1.000$14 per 1.000
Bij de Agent API worden websearch, het ophalen van URL’s, zoeken naar personen, financiële zoekopdrachten en de codeomgeving afzonderlijk afgerekend wanneer de agent die hulpmiddelen gebruikt.
Prijzen, modellen en pakketnamen kunnen veranderen. Controleer daarom vóór productiegebruik altijd de officiële prijsdocumentatie en onze bredere uitleg over Perplexity-prijzen en abonnementen.

Stap 1: maak een API-omgeving aan

Ga naar de Perplexity API-console en log in met je Perplexity-account.
Maak vervolgens een API Group aan. Dit is de centrale omgeving voor:
  • facturering;
  • credits;
  • API-sleutels;
  • teamleden;
  • gebruiksstatistieken;
  • limieten.
Volgens de uitleg over API Groups en facturering moet een beheerder eerst de organisatiegegevens en betaalmethode instellen. Daarna kun je credits kopen of automatisch laten aanvullen.

Stap 2: maak een API-key

Open in de console het onderdeel API keys en kies Generate API Key.
Een API-key is een geheime toegangscode. Iedereen met deze sleutel kan binnen jouw account API-verzoeken uitvoeren en kosten veroorzaken.
Zet de sleutel daarom nooit:
  • in openbare broncode;
  • in een GitHub-repository;
  • in JavaScript dat in de browser van bezoekers draait;
  • in een mobiele app zonder veilige serverlaag;
  • in screenshots of documentatie;
  • rechtstreeks in een WordPress-thema of plug-inbestand dat kan worden gedownload.
Bewaar de sleutel in een omgevingsvariabele of een secrets manager.
Op macOS en Linux:
export PERPLEXITY_API_KEY="jouw_api_key"
In Windows PowerShell:
$env:PERPLEXITY_API_KEY="jouw_api_key"
Commit een .env-bestand met echte sleutels nooit naar versiebeheer.

Stap 3: installeer de officiële SDK

Voor Python:
pip install perplexityai
Voor JavaScript en TypeScript:
npm install @perplexity-ai/perplexity_ai
Perplexity biedt daarnaast compatibiliteit met de OpenAI SDK. De officiële SDK is meestal de eenvoudigste keuze voor nieuwe toepassingen, omdat typen en nieuwe Perplexity-functies daar rechtstreeks in worden ondersteund.

Eerste Perplexity API-aanroep met Python

Dit voorbeeld gebruikt Sonar Pro voor een actueel antwoord met webbronnen:
from perplexity import Perplexity client = Perplexity() completion = client.chat.completions.create( model="sonar-pro", messages=[ { "role": "system", "content": ( "Geef een beknopt Nederlands antwoord. " "Gebruik primaire bronnen voor actuele feiten " "en vermeld onzekerheid expliciet." ), }, { "role": "user", "content": ( "Welke onderdelen van de Europese AI Act " "zijn in 2026 relevant voor een Nederlands mkb-bedrijf?" ), }, ], ) print(completion.choices[0].message.content) for url in completion.citations or []: print(url)
De SDK leest PERPLEXITY_API_KEY automatisch uit de omgevingsvariabele.
Het antwoord bevat naast de gegenereerde tekst onder meer:
  • het gebruikte model;
  • citaties;
  • zoekresultaten;
  • tokengebruik;
  • informatie over de afronding van het verzoek.
Controleer bij productiegebruik niet alleen de tekst. Bewaar ook de bron-URL’s, het model, de aanvraagdatum en relevante gebruiksgegevens.

Perplexity API gebruiken met JavaScript

import Perplexity from "@perplexity-ai/perplexity_ai"; const client = new Perplexity(); const completion = await client.chat.completions.create({ model: "sonar-pro", messages: [ { role: "system", content: "Geef een beknopt Nederlands antwoord en gebruik primaire bronnen voor actuele feiten.", }, { role: "user", content: "Welke onderdelen van de Europese AI Act zijn in 2026 relevant voor een Nederlands mkb-bedrijf?", }, ], }); console.log(completion.choices[0].message.content); for (const url of completion.citations ?? []) { console.log(url); }
Voer deze code uit op je server, bijvoorbeeld in een Node.js-back-end. Zet de API-key niet in front-endcode die naar de browser wordt gestuurd.

Een verzoek uitvoeren met cURL

Voor een snelle test zonder programmeerproject kun je cURL gebruiken:
curl https://api.perplexity.ai/v1/sonar \ -H "Authorization: Bearer $PERPLEXITY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "sonar-pro", "messages": [ { "role": "user", "content": "Leg in het Nederlands uit wat retrieval-augmented generation is." } ] }'
De API-key wordt via de Authorization-header meegestuurd. Gebruik het type Bearer.

De Search API gebruiken

De Search API geeft geen volledig geschreven antwoord. Je krijgt gerangschikte webresultaten die je zelf kunt verwerken.
Een Python-voorbeeld:
from perplexity import Perplexity client = Perplexity() search = client.search.create( query="Europese AI Act officiële planning 2026", max_results=5, search_context_size="high", ) for result in search.results: print(result.title) print(result.url) print(result.snippet) print()
Dit is nuttig wanneer je:
  • zelf een zoekinterface bouwt;
  • alleen URL’s en fragmenten nodig hebt;
  • resultaten aan een ander model geeft;
  • eigen regels voor bronselectie toepast;
  • resultaten opslaat voor analyse;
  • het geschreven antwoord zelf wilt bepalen.
De officiële Search API-documentatie ondersteunt onder meer meerdere zoekvragen, domeinfilters, taal- en regiokeuzes en verschillende hoeveelheden opgehaalde context.

De Agent API gebruiken

De Agent API combineert modellen en hulpmiddelen in één omgeving. Je kunt modellen van Perplexity, OpenAI, Anthropic, Google, xAI en andere aanbieders via dezelfde API-key benaderen.
Een eenvoudig voorbeeld met een preset:
from perplexity import Perplexity client = Perplexity() response = client.responses.create( preset="low", input=( "Onderzoek de belangrijkste officiële wijzigingen " "in de Europese AI Act-planning in 2026. " "Geef een Nederlands antwoord met bronverwijzingen." ), ) print(response.output_text)
Presets geven Perplexity ruimte om een passende configuratie te kiezen. Voor meer controle kun je zelf een model, hulpmiddelen, redeneerinstellingen en tokenbudget opgeven.
De Agent API gebruikt:
POST https://api.perplexity.ai/v1/agent
Voor compatibiliteit met het OpenAI Responses-formaat is ook /v1/responses beschikbaar. Bekijk voor nieuwe implementaties de officiële Agent API-handleiding.

Sonar, Sonar Pro of Deep Research kiezen

Gebruik niet automatisch het zwaarste model. Een productprijs, bedrijfsadres of korte actuele definitie heeft meestal geen Deep Research nodig.
Voor een onderzoeksrapport via de gewone Perplexity-interface kun je onze complete handleiding voor Perplexity Research gebruiken. De API-versie is vooral bedoeld wanneer het onderzoek onderdeel wordt van je eigen toepassing.

Zo schrijf je een goede API-prompt

Een API-prompt moet niet alleen het onderwerp noemen. Leg ook vast hoe de bronselectie en uitvoer moeten werken.
Een bruikbare opbouw:
  1. Rol: welk soort assistent moet het model zijn?
  2. Taak: wat moet het onderzoeken of beantwoorden?
  3. Afbakening: welke periode, regio en definitie gelden?
  4. Bronbeleid: welke bronnen hebben voorrang?
  5. Uitvoer: welke structuur of gegevensvorm verwacht je?
  6. Onzekerheid: hoe moet ontbrekende informatie worden behandeld?
Voorbeeld:
Je bent een onderzoeksassistent voor een Nederlandse zakelijke website. Onderzoek welke officiële wijzigingen sinds 1 januari 2026 zijn gepubliceerd over de Europese AI Act. Gebruik bij voorkeur bronnen van de Europese Unie en Nederlandse toezichthouders. Gebruik nieuwsmedia alleen voor aanvullende context. Scheid: 1. vastgestelde wetgeving; 2. officiële uitvoeringsplanning; 3. voorstellen of interpretaties; 4. praktisch advies. Geef de uitkomst als JSON met de velden: title, status, effective_date, jurisdiction, summary en source_url. Verzin geen datum wanneer die niet officieel is vastgesteld.

Citaties goed verwerken

Een API-antwoord kan genummerde verwijzingen in de tekst bevatten. De bijbehorende URL’s staan afzonderlijk in de respons.
Sla daarom niet alleen de gegenereerde tekst op. Bewaar ook:
  • de citatielijst;
  • de zoekresultaten;
  • publicatie- en updatedata waar beschikbaar;
  • het gebruikte model;
  • het tijdstip van de aanvraag;
  • je eigen interne request-id.
Een citatie maakt een antwoord niet automatisch juist. Controleer bij belangrijke toepassingen of de bron de specifieke bewering werkelijk ondersteunt.
Als je de tekst later verandert, kunnen citatienummers niet meer overeenkomen met de juiste bronnen. Bewerk daarom niet willekeurig stukken tekst zonder de bronkoppeling opnieuw op te bouwen.

Streaming gebruiken

Bij streaming ontvang je het antwoord in kleine delen zodra deze beschikbaar zijn. Dat is nuttig voor chatbots en lange antwoorden, omdat de gebruiker niet op het volledige resultaat hoeft te wachten.
Bij Sonar zet je daarvoor stream=True:
from perplexity import Perplexity client = Perplexity() stream = client.chat.completions.create( model="sonar", messages=[ { "role": "user", "content": "Leg de basis van RAG uit in vijf korte onderdelen.", } ], stream=True, ) for chunk in stream: if chunk.choices[0].delta.content: print(chunk.choices[0].delta.content, end="", flush=True)
De officiële uitleg over streaming en gestructureerde uitvoer vermeldt dat zoekresultaten en gebruiksmetadata meestal pas in de laatste delen van de stream worden meegestuurd.

Gestructureerde uitvoer gebruiken

Voor automatisering is vrije tekst vaak onhandig. Een model kan koppen, volgorde of formuleringen veranderen. Met structured outputs kun je een vast JSON-schema afdwingen.
Dat is geschikt voor:
  • productgegevens;
  • nieuwsmonitoring;
  • concurrentieoverzichten;
  • bronregisters;
  • rapportages;
  • gegevens die naar een database gaan.
Controleer de uitvoer alsnog op:
  • ontbrekende verplichte waarden;
  • verkeerd geïnterpreteerde datums;
  • bedragen en valuta;
  • bron-URL’s;
  • duplicaten;
  • ongeldige of onverwachte categorieën.
Een technisch geldig JSON-object kan inhoudelijk nog steeds onjuist zijn.

Kosten beheersen

Kies het lichtste geschikte model

Gebruik Sonar voor korte actuele antwoorden en Sonar Pro wanneer extra zoekdiepte werkelijk nodig is. Reserveer Deep Research voor opdrachten waarvoor meerdere zoekrondes waarde toevoegen.

Beperk de uitvoer

Lange antwoorden kosten meer outputtokens. Vraag alleen om de onderdelen die je toepassing daadwerkelijk gebruikt.

Gebruik lagere zoekcontext waar mogelijk

Een hoge zoekcontext haalt meer webinformatie op, maar heeft een hogere prijs per verzoek. Test eerst of een lage of middelgrote context voldoende is.

Cache stabiele informatie

Een uitleg van een vast begrip hoeft niet bij iedere paginaweergave opnieuw te worden opgehaald. Prijzen, nieuws en wettelijke ontwikkelingen verouderen sneller en vragen een kortere cacheperiode.

Stel budgetwaarschuwingen in

Controleer de kosten in de API-console. Laat een productietoepassing niet onbeperkt verzoeken uitvoeren wanneer een fout, bot of herhaalde taak ontstaat.

Sla mislukte verzoeken niet blind opnieuw in

Gebruik bij tijdelijke fouten een beperkt aantal pogingen en oplopende wachttijden. Anders kan één fout duizenden nieuwe verzoeken veroorzaken.

Rate limits en foutafhandeling

Perplexity gebruikt gebruiksniveaus voor verschillende API’s en modellen. Nieuwe accounts beginnen met lagere limieten. Bij meer gekocht tegoed kunnen hogere niveaus beschikbaar komen.
Wanneer je te veel verzoeken verstuurt, kan de API een 429 Too Many Requests teruggeven.
Een productieomgeving moet daarom:
  • 429 herkennen;
  • exponential backoff met willekeurige vertraging gebruiken;
  • een maximumaantal nieuwe pogingen instellen;
  • time-outs afhandelen;
  • verzoeken van een unieke interne identifier voorzien;
  • fouten loggen zonder de volledige gevoelige prompt op te slaan.
De actuele aantallen staan in het officiële overzicht van rate limits.

Is de Perplexity API veilig?

Perplexity stelt dat prompt- en antwoordinhoud van de API niet wordt bewaard en niet voor modeltraining wordt gebruikt. De dienst bewaart wel noodzakelijke factureringsmetadata, zoals tokenaantallen, model, tijdstip, duur en gebruikte API-key.
De officiële API-uitleg over privacy en beveiliging noemt een zero-data-retentionbeleid voor Chat Completions en een SOC 2 Type II-rapport.
Dat neemt jouw eigen verantwoordelijkheden niet weg. Je toepassing kan prompts, antwoorden en persoonsgegevens zelf loggen. Ook hostingdiensten, monitoringsoftware en foutmeldingsdiensten kunnen gegevens opslaan.
Gebruik daarom:
  • server-side API-aanroepen;
  • afzonderlijke sleutels per omgeving;
  • minimale toegangsrechten;
  • sleutelrotatie;
  • versleuteling tijdens transport en opslag;
  • beperkte logging;
  • een bewaarbeleid;
  • controle op persoonsgegevens en bedrijfsgeheimen;
  • menselijke beoordeling bij risicovolle beslissingen.
Een uitgebreidere beoordeling staat in ons artikel over privacy en veiligheid bij Perplexity.

Veelgemaakte fouten

Een API-key in de browser zetten

Front-endcode is zichtbaar voor bezoekers. Iedereen kan de sleutel kopiëren en op jouw kosten gebruiken. Stuur aanvragen via je eigen server.

Denken dat Pro ook API-tegoed bevat

De consumentenapp en API worden afzonderlijk afgerekend. Een betaald abonnement voorkomt geen API-kosten.

Deep Research voor iedere vraag gebruiken

Dat verhoogt kosten en verwerkingstijd zonder dat een eenvoudige vraag noodzakelijk beter wordt beantwoord.

Alleen de geschreven tekst opslaan

Zonder citaties, modelnaam en datum kun je later moeilijk controleren waar het antwoord vandaan kwam.

Iedere bron als betrouwbaar behandelen

De API kan een commerciële, verouderde of secundaire bron selecteren. Voeg bronregels toe en controleer belangrijke claims.

Geen maximum op gebruikersinvoer zetten

Een bezoeker kan extreem lange of dure verzoeken indienen. Beperk lengte, aantal aanvragen en beschikbare functies.

Antwoorden direct publiceren

Controleer feiten, brongebruik, auteursrecht, persoonsgegevens en toon voordat API-uitvoer openbaar wordt gemaakt.

Veelgestelde vragen

Heb ik Perplexity Pro nodig voor de API?

Nee. De API heeft een afzonderlijke facturering. Je kunt API-toegang gebruiken zonder Pro-abonnement, mits je een API Group, betaalmethode en tegoed instelt.

Krijg ik gratis API-tegoed bij Pro of Max?

Nee. Perplexity vermeldt dat API-verbruik apart wordt afgerekend en dat abonnementen geen inbegrepen API-credits geven.

Kan ik de OpenAI SDK gebruiken?

Ja. Sonar ondersteunt het OpenAI Chat Completions-formaat. Je gebruikt je Perplexity-key en stelt https://api.perplexity.ai als basis-URL in.

Heeft de Perplexity API actuele internettoegang?

Ja. Sonar en de websearchfuncties van de Agent API zijn bedoeld voor actuele, webgebaseerde antwoorden. De Search API geeft ruwe actuele zoekresultaten.

Geeft de API bronverwijzingen?

Ja. Sonar en webgebaseerde Agent-antwoorden kunnen citaties en zoekresultaten teruggeven. Controleer altijd of de bron de bewering volledig ondersteunt.

Welke API is het goedkoopst?

Dat hangt af van de opdracht. De Search API is goedkoop wanneer je alleen ruwe resultaten nodig hebt. Sonar is doorgaans de voordeligste optie voor een kort gegenereerd antwoord met websearch.

Kan ik de API in WordPress gebruiken?

Ja, maar voer de aanvraag server-side uit. Plaats de API-key niet in JavaScript of openbare thema- en plug-inbestanden.

Worden API-gegevens gebruikt voor training?

Perplexity zegt dat API-inhoud niet voor training wordt gebruikt en standaard niet wordt bewaard. Factureringsmetadata wordt wel geregistreerd.

Kan ik de API gebruiken voor medische of juridische antwoorden?

Technisch kan dat, maar behandel het resultaat niet als zelfstandig professioneel advies. Gebruik gecontroleerde bronnen, domeinexperts, menselijke goedkeuring en passende nalevingsmaatregelen.

Conclusie: zo begin je met de Perplexity API

Begin klein:
  1. maak een API Group en sleutel aan;
  2. bewaar de sleutel als omgevingsvariabele;
  3. test Sonar met één duidelijke vraag;
  4. sla tekst, citaties, model en datum samen op;
  5. vergelijk de uitkomst met de oorspronkelijke bronnen;
  6. stel kosten- en gebruikslimieten in;
  7. schaal pas op nadat foutafhandeling en beveiliging werken.
Gebruik de Agent API wanneer je een complete assistent of agent met verschillende modellen en hulpmiddelen bouwt. Gebruik de Search API voor ruwe resultaten en Sonar voor een relatief eenvoudige integratie van actuele antwoorden met citaties.
Zo voeg je de sterke zoeklaag van Perplexity aan je eigen software toe zonder de controle over bronnen, kosten en gegevens uit handen te geven. Volg voor nieuwe modellen en wijzigingen het laatste nieuws over Perplexity.
loading

Populair nieuws

Laatste reacties

Loading