Exa instellen: een zoek-API die je agent leesbare webtekst teruggeeft

Je bouwt een agent die actuele informatie nodig heeft. De klassieke route: een zoek-API aanroepen, de links eruit vissen, elke pagina zelf ophalen, HTML opschonen en dan pas iets aan je taalmodel voeren. Exa slaat die drie middelste stappen over: je krijgt de gevonden pagina’s mét bruikbare tekst in één antwoord terug. Hieronder in vier stappen van aanmelden naar een werkende call.

Stap 1: sleutel ophalen en klaarzetten

Maak een account aan via het Exa-dashboard en haal je sleutel op bij API keys. Het Starter-plan vraagt geen betaalmethode en geeft 20 dollar aan credits bij aanmelden plus 10 dollar per maand.

Zet de sleutel als omgevingsvariabele, niet in je code:

export EXA_API_KEY="jouw-sleutel"

💡 Beginner-tip: een omgevingsvariabele is een waarde die buiten je bestand leeft, zodat je sleutel niet per ongeluk in Git belandt. Zet ‘m in je shell-profiel of in een .env in je projectmap — en zet die .env in je .gitignore.

Stap 2: de SDK installeren

Exa heeft SDK’s voor Python en JavaScript. Kies er één:

pip install exa-py       # Python
npm install exa-js       # JavaScript

Stap 3: je eerste zoekopdracht

Het minimale voorbeeld is drie regels. De client leest EXA_API_KEY vanzelf uit je omgeving:

from exa_py import Exa

exa = Exa()

result = exa.search(
    "blog post about artificial intelligence",
    type="auto",
    contents={"highlights": True},
)

Twee velden doen hier het werk. type="auto" laat Exa zelf de zoekstrategie kiezen, wat ongeveer een seconde duurt. contents={"highlights": True} zorgt dat je per resultaat korte fragmenten terugkrijgt in plaats van de hele pagina.

Dat tweede veld is de reden dat je hier tokens bespaart. Een volledige webpagina kost je al gauw duizenden tokens waarvan het meeste navigatie en voettekst is; highlights geven alleen de passages die bij je vraag horen. Exa raadt rond de 4.000 tekens per pagina aan.

Liever eerst zonder SDK proberen? Dan werkt dit ook:

curl -s -X POST "https://api.exa.ai/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EXA_API_KEY" \
  -d '{"query": "blog post about artificial intelligence", "type": "auto", "contents": {"highlights": true}}'

Stap 4: bijsturen op snelheid, bron en vorm

Vanaf hier stel je af op wat je toepassing nodig heeft. Drie knoppen die je het vaakst gebruikt:

Snelheid versus diepte — het veld type:

Type	Snelheid	Waarvoor
auto	~1 seconde	Standaard, als je twijfelt
instant	~250 ms	Realtime chat en spraak
fast	~450 ms	Snelheid met weinig kwaliteitsverlies
deep-lite	~4 seconden	Lichte synthese over meerdere bronnen
deep	4-15 seconden	Meerstaps redeneren met gestructureerde output
deep-reasoning	12-40 seconden	Zwaardere onderzoeksvragen

Bronnen inperken — include_domains en exclude_domains accepteren ook padvoorvoegsels en subdomein-jokers:

results = exa.search(
    "latest product announcements",
    include_domains=["exa.ai/blog"],
)

Gestructureerde output — met output_schema geef je een JSON-schema mee en krijg je velden terug in plaats van losse tekst. Dat werkt bij elk search type, maar is vooral nuttig bij deep en hoger, waar Exa daadwerkelijk over meerdere bronnen synthetiseert.

Daarnaast kun je zoeken binnen een categorie in plaats van het hele web: company, people, publication, news, personal site en financial report. Weet je vooraf welk soort bron je nodig hebt, dan scheelt dat ruis.

⚡ Gevorderden: reken je kosten door vóór je een agent loslaat. De basisprijs van 7 dollar per 1.000 Search-verzoeken dekt tien resultaten; elk resultaat daarboven kost 1 dollar extra per 1.000 verzoeken, en AI-samenvattingen van pagina’s zijn 1 dollar per 1.000 pagina’s. Een agent die per gebruikersvraag drie keer zoekt met twintig resultaten is dus niet drie keer maar bijna zes keer zo duur als je ruwe schatting. Dezelfde afweging maakten we bij AI-agents evalueren met LangChain.

Checklist: ben je klaar?

• Account aangemaakt en API-sleutel opgehaald bij dashboard.exa.ai
• EXA_API_KEY staat in je omgeving, niet in je code
• SDK geïnstalleerd (exa-py of exa-js)
• Eerste search-call geeft resultaten terug
• contents={"highlights": True} staat aan in plaats van volledige tekst
• type bewust gekozen op basis van je wachttijd-budget
• Domeinfilters ingesteld als je agent maar een handvol bronnen mag raadplegen
• Kosten per gebruikersvraag doorgerekend vóór je opschaalt

Wil je eerst begrijpen wat zo’n agent nu eigenlijk is voordat je er een zoek-API aan hangt, dan is AI-agents in 2026: wat zijn ze precies? op hetlaatsteainieuws.nl een goede opstap. Zoek je liever een kant-en-klare onderzoeksassistent in plaats van een API, kijk dan naar Research doen met AI: Perplexity en NotebookLM.

Stand van zaken — bijgewerkt 2026-09-05

• Gratis Starter: 20 dollar credits bij aanmelden plus 10 dollar per maand, geen betaalmethode nodig, 10 zoekopdrachten per seconde.
• Endpoint-prijzen: Search 7 dollar, Deep Search 12 dollar, deep-reasoning 15 dollar en Monitors 15 dollar per 1.000 verzoeken; Answer 5 dollar per 1.000; Contents 1 dollar per 1.000 pagina’s per contenttype.
• Resultaten boven de tiende: 1 dollar extra per 1.000 verzoeken. AI-paginasamenvattingen: 1 dollar per 1.000 pagina’s.
• Search types: auto, instant, fast, deep-lite, deep, deep-reasoning.
• Zonder code: MCP-server, Claude-connector en ChatGPT-plugin beschikbaar.

Bronnen

• Exa — Search API guide (documentatie)
• Exa — API pricing
• Exa — MCP-server