Snel antwoord
Hoe voer ik mijn eerste zoekopdracht uit met een web search API voor AI-agents?
Stuur je vraag naar POST https://llmwebsearch.com/api/v1/search met je API-sleutel als Bearer-token. LLMWebSearch voert een live webzoekopdracht uit en retourneert tot 20 gerangschikte resultaten, waarbij de eerste 3 pagina's zijn gelezen en teruggegeven als Markdown. Eén credit betaalt die hele aanroep, vanaf US$ 1,20/1K zoekopdrachten per oktober 2026. Zonder KYC; betalen met crypto.
De API op één kaart
| Base URL | https://llmwebsearch.com/api/v1 |
|---|---|
| Zoeken | POST of GET https://llmwebsearch.com/api/v1/search |
| Lees URL's die je al hebt | POST https://llmwebsearch.com/api/v1/extract |
| Resterende credits | GET https://llmwebsearch.com/api/v1/credits, gratis |
| Authenticatie | Geef je API-sleutel mee als Bearer-token in de Authorization-header, of als de queryparameter api_key |
| Facturering | Eén credit betaalt één zoekopdracht: tot 20 gerangschikte resultaten, waarbij de pagina's van de eerste 3 worden gelezen en als Markdown teruggegeven. Het lezen van 4 tot 10 pagina's kost 2 credits. Een call die op een fout eindigt, kost niets |
| Onze pagina-lezer | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), robots.txt-token LLMWebSearch |
| Kleinste pack | 5.000 zoekopdrachten voor US$ 9,25; credits verlopen nooit |
Hoe krijg ik een API-sleutel?
Er is geen aanmeldformulier. Wachten tot de blockchain je opwaardering bevestigt, duurt het langst.
Zet saldo op je account met crypto
Stuur minimaal US$ 25 in BTC, USDT, USDC, ETH, SOL, LTC. Log in met een accountnummer; een e-mailadres is optioneel.
Koop een pack zoekopdrachten
5.000 zoekopdrachten voor US$ 9,25 is ruim genoeg om zoeken in één agent te bouwen en elke optie uit te proberen.
Kopieer de sleutel
Zodra je crypto-opwaardering is bevestigd en er een pack is gekocht, staat je API-sleutel klaar in het dashboard. Bewaar hem in een environment variable genaamd
LLMWEBSEARCH_API_KEY.
Hoe ziet de eerste zoekopdracht eruit?
Het is één HTTPS POST met een kleine JSON-body. Alleen q is verplicht: de vraag of trefwoorden, zoals iemand ze zou typen. De standaardwaarden passen al bij de meeste agents. Je krijgt 5 gerangschikte resultaten, en de pagina's achter de eerste 3 worden gelezen en teruggegeven als Markdown van maximaal 6.000 tekens per stuk.
De drie snippets hieronder versturen dezelfde zoekopdracht. Kies degene die bij je stack past, stel LLMWEBSEARCH_API_KEY in je shell in en voer hem uit.
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3}'import os
import requests
resp = requests.post(
"https://llmwebsearch.com/api/v1/search",
headers={"Authorization": "Bearer " + os.environ["LLMWEBSEARCH_API_KEY"]},
json={"q": "how to rotate api keys without downtime", "max_results": 5, "read": 3},
timeout=60,
)
resp.raise_for_status()
data = resp.json()
print("credits used:", data["credits_used"])
for r in data["results"]:
size = r.get("word_count", 0)
print(r["position"], r["title"], r["url"], r["content_status"], size, "words")
const res = await fetch('https://llmwebsearch.com/api/v1/search', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.LLMWEBSEARCH_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({ q: 'how to rotate api keys without downtime', max_results: 5, read: 3 }),
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
const first = data.results.find((r) => r.content_status === 'ok');
console.log(first ? `${first.title}\n${first.url}\n\n${first.content.slice(0, 600)}` : 'No page could be read.');
Wat komt er terug?
Een JSON-object met je query, het tijdstip van de call in created_at, de prijs in credits_used en een results-array in gerangschikte volgorde. Elk resultaat heeft zijn position, title, url, host en snippet, plus published_at wanneer de datum bekend is.
Het veld om op te letten is content_status. Als er ok staat, is de pagina gelezen en staat de hoofdinhoud in content, met een word_count. Resultaten na read zeggen not_requested. Een pagina die niet gelezen kon worden, vermeldt waarom, bijvoorbeeld blocked_by_robots. De pagina over het responseformat legt elk veld uit.
Welke parameters zal ik het vaakst wijzigen?
Zes parameters dekken bijna elke agent. Ze zijn allemaal optioneel.
| Parameter | Wat het wijzigt |
|---|---|
max_results | Hoeveel gerangschikte resultaten terugkomen, van 1 tot 20 |
read | Hoeveel van de eerste resultaten worden gelezen, van 0 tot 10 |
max_chars | De maximale lengte van de inhoud per pagina, 500 tot 50.000 tekens |
topic en time_range | Nieuws in plaats van webpagina's, en een versheidsvenster |
include_domains | Resultaten alleen van de sites die je opgeeft |
country en language | Waar en in welke taal de zoekopdracht wordt uitgevoerd |
De zoekreferentie documenteert elk ervan met een voorbeeld, plus format en exclude_domains.
Hoeveel credits gebruikt een call?
De meeste calls gebruiken er één. De volledige regelset:
- Zoeken met 0 tot 3 gelezen pagina's: 1 credit. Dat omvat tot 20 gerangschikte resultaten.
- Zoeken met 4 tot 10 gelezen pagina's: 2 credits.
- Extraheren: Het lezen van pagina's waarvan je de URL's al hebt, kost 1 credit per begonnen groep van 3 pagina's die met inhoud worden teruggegeven, tot 20 URL's per call; geweigerde of mislukte URL's tellen niet mee.
- Fouten: 0 credit. Een verkeerde parameter, een verkeerde sleutel, een leeg saldo of een mislukte zoekopdracht kost niets.
- Een pagina die niet gelezen kon worden binnen een geslaagde zoekopdracht verandert de prijs niet.
- Je saldo checken met
GET https://llmwebsearch.com/api/v1/creditsis gratis.
Zoekcredits verlopen niet: wat je deze maand niet gebruikt, staat er volgend jaar nog.
Wat gebeurt er als een site niet gelezen wil worden?
Het resultaat verschijnt nog steeds, met zijn titel, URL en snippet, maar zonder de pagina-inhoud. Onze reader respecteert robots.txt: hij stelt zich voor als LLMWebSearch, volgt de regels die een site voor hem of voor alle robots schrijft, en laat de inhoud weg van elke pagina die hij niet mag lezen. Een site die Content-Signal: ai-input=no in zijn robots.txt zet, houdt zijn pagina's buiten de inhoud van je resultaten.
Als een site onze reader een weigering terugstuurt, draagt het resultaat content_status: "target_refused" en de eigen HTTP-status van de site in target_status. Wanneer een site onze reader weert, komt het resultaat terug zonder inhoud en met de status van de site: we lossen nooit CAPTCHA's op, loggen nooit in op accounts en werken nooit om een blokkade of een paywall heen. De pagina over fouten somt elke status op en welke een nieuwe poging waard zijn.
Waar ga ik hierna naartoe?
- Search endpoint Elke parameter van /search, met voorbeelden
- Extract endpoint Lees 1 tot 20 URL's die je al hebt
- Responseformaat Elk veld en elke content_status
- Fouten HTTP-fouten, paginastatussen, regels voor opnieuw proberen
- Python requests, async httpx, een antwoord met citaties
- Node.js fetch, een kleine pool, dezelfde citatielus
- curl en jq Terminal-recepten
- MCP server search_web voor Claude Code en Claude Desktop
- LangChain en LlamaIndex Een tool en een retriever
- OpenAI function calling Toolschema, loop en Agents SDK
- n8n HTTP Request-tool voor een AI Agent
- OpenClaw Ons zoeken via MCP
Snelstart: veelgestelde vragen
Heb ik een SDK nodig?
Nee. LLMWebSearch is een gewone HTTPS API, dus elke HTTP-client werkt. Deze docs geven copy-paste-code voor Python, Node.js en curl, en tooldefinities voor MCP, LangChain, LlamaIndex, OpenAI function calling, n8n en OpenClaw. We publiceren geen package.
Schrijft de API het antwoord voor me?
Nee. De API geeft bronnen terug, geen geschreven antwoord: je eigen model leest de pagina's, schrijft het antwoord en citeert de URL's. Zo houd je zelf de keuze van het model, de prompt en de citatiestijl.
Kan ik de sleutel in de URL zetten?
Ja, als de queryparameter api_key van GET /search. De header Authorization is de veiligere keuze, omdat URL's in logs en shell-geschiedenis belanden. Maak één API-sleutel per agent, app of teamgenoot en trek elk ervan in vanuit het dashboard zonder de andere te raken.
Is er een gratis tier om het uit te proberen?
Nee. Er is geen gratis tier: het pack van 5.000 zoekopdrachten is de manier om het uit te proberen, gekocht vanaf de minimale opwaardering; wat je alleen hebt toegevoegd om dat minimum te halen, krijg je op verzoek binnen 30 dagen terug, in USDT of USDC, zolang het niet is besteed.