Michael JohnsonCloudflare introduceerde Web Search API op 2 oktober 2026 via AI Gateway: een interface voor webzoeken voor AI-agents en applicaties. Bij de lancering sloot het bedrijf Ceramic.ai, Exa en Linkup aan. De officiële documentatie op hoofdlijnen, gecontroleerd op 8 oktober en bijgewerkt op 2 oktober, vermeldt dat het product in open bèta is.
Voor ontwikkelaars is de belangrijkste verandering dat ze zoeken kunnen toevoegen aan een bestaande workflow voor modellen. Volgens de beschrijving van de integratie met AI Gateway krijgen zoekaanvragen dezelfde logging, analyses, facturering en toegangsbeheer als modelaanvragen. Daardoor kan zoeken worden behandeld als een afzonderlijke, waarneembare stap in de uitvoering van een agenttaak.
Waarom een agent een zoekopdracht nodig heeft
In de aankondiging van Cloudflare staat een praktisch probleem centraal: een agent kan gokken naar het adres van de gewenste pagina, waarna een aanvraag naar de onjuiste URL een 404-fout oplevert. Een zoekfunctie biedt een andere aanpak: een zoekopdracht formuleren, adressen van relevante bronnen ophalen en de gevonden informatie gebruiken om een antwoord op te stellen.
Een tweede toepassing is omgaan met veranderingen die plaatsvonden nadat een model is getraind. Cloudflare noemt specifiek recente gebeurtenissen, veranderende API's en nieuwe toolreleases. Voor een agent die helpt bij programmeren, kan het nuttig zijn om documentatie voor een specifieke bibliotheekversie of een recent toegevoegde parameter op te zoeken. In zo'n proces levert de zoekfunctie materiaal voor de context, terwijl de applicatie bepaalt welke resultaten naar het model gaan.
Een praktische tip voor teams: bewaar de URL en de zoekopdracht samen met het gevonden fragment. Zo kun je bij het controleren van een antwoord achterhalen op welke bron de agent zich baseerde. Voor taken waarbij versies een rol spelen, is het ook nuttig om de productnaam en de gewenste versie expliciet in de zoekopdracht op te nemen.
Zo koppel je de nieuwe API aan
De documentatie beschrijft twee manieren om de API aan te roepen: de REST API vanuit een externe backend en een AI-binding binnen Cloudflare Workers. Je kiest een provider met de parameter provider. Alle drie de diensten leveren resultaten in een gemeenschappelijk formaat: titels, URL's en beschrijvingen. Dat maakt het eenvoudiger om van leverancier te wisselen zonder de manier waarop de applicatie antwoorden verwerkt aan te passen.
Een gemeenschappelijk formaat is handig voor een eigen adapter voor de zoekfunctie. Die ontvangt de zoekopdracht van de agent, roept de gekozen provider aan en geeft geselecteerde resultaten door aan het model. Het is verstandig om op applicatieniveau afzonderlijk te bepalen wanneer een beschrijving uit de zoekresultaten volstaat en wanneer de gevonden pagina moet worden gelezen om een specifieke bewering te controleren.
De ingebouwde servertools van AI Gateway worden in de aankondiging van de lancering genoemd als een toekomstige mogelijkheid. Cloudflare meldt dat webzoeken een van de eerste tools van dit type zal zijn. Het voorbeeld bij de lancering gaat uit van eigen orkestratie: de applicatie verwerkt de toolaanroep en geeft het zoekantwoord mee in de volgende aanvraag aan het model.
Welke voorwaarden zijn bevestigd
Volgens de betalingsvoorwaarden in de documentatie kun je aanvragen betalen met AI Gateway-tegoed, tegen de openbare API-prijs van de betreffende provider en zonder extra opslag van Cloudflare. Bring Your Own Key wordt ook ondersteund: je gebruikt dan je eigen API-sleutel van de zoekprovider. Als je voor deze aanpak kiest, is het verstandig vooraf te bepalen waar je het verbruik bijhoudt en hoe je de in rekening gebrachte bedragen controleert.
De gecontroleerde aankondiging en overzichtspagina vermelden geen concrete tarieven of numerieke limieten voor het aantal zoekopdrachten. Bereken het budget voor de integratie daarom nadat je het tarief van de gekozen provider hebt gecontroleerd. Je kunt acceptatietests baseren op je eigen taken, bijvoorbeeld op het aandeel bruikbare bronnen, de reactietijd, het aantal zoekaanvragen per afgeronde taak en de foutafhandeling.
Ook gegevensopslag verdient aandacht. In de beschrijving van Zero Data Retention belooft Cloudflare aan te geven welke partners ZDR ondersteunen. Controleer voor de specifieke zoekroute afzonderlijk de opslagvoorwaarden van de provider en de instellingen voor AI Gateway-logs: de aankondiging bevestigt ook dat zoekaanvragen in het observatiesysteem worden geregistreerd.
Providers verplichten zich bovendien te voldoen aan de vereisten van Cloudflare voor Verified bots: ze moeten hun bot identificeren, rekening houden met robots.txt en crawlrichtlijnen, een redelijke aanvraagfrequentie aanhouden en de voorkeuren van website-eigenaren respecteren. Het overzicht van Web Search API bevestigt dat bij elk resultaat een bronverwijzing verplicht is.
Voor ontwikkelaars biedt deze lancering een duidelijk aansluitpunt om webzoeken aan een agent toe te voegen, met een gezamenlijke manier om het gebruik ervan bij te houden. Begin de evaluatie met een kleine reeks realistische taken, een expliciete keuze van provider en het bewaren van links in antwoorden. Die keuzes bepalen hoe goed de gevonden bronnen de applicatie helpen om concrete taken uit te voeren.