# Quick start voor de web search API: je eerste zoekopdracht in twee minuten

> Web search API quick start: vraag een API-sleutel aan, voer je eerste zoekopdracht uit en lees pagina's als Markdown. Betaal met crypto, zonder KYC.

- URL: https://llmwebsearch.com/nl/docs/
- Laatst bijgewerkt: 2026-10-22
- Uitgever: LLMWebSearch (https://llmwebsearch.com)

Eén endpoint doet het werk: stuur een vraag naar `/search` en krijg gerangschikte resultaten terug, waarbij de eerste pagina's al zijn gelezen en opgeschoond naar Markdown. Deze pagina gaat van een leeg saldo naar een werkende aanroep en wijst daarna naar elke andere pagina van de docs.

**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

| Attribuut | Waarde |
| --- | --- |
| 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.

1. **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.
2. **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.
3. **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: één zoekopdracht, top 3 pagina's gelezen*

```bash
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}'
```

*Python: toon de bronnen en hun grootte*

```python
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")

```

*Node.js 18+: toon de eerste pagina die is gelezen*

```javascript
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](https://llmwebsearch.com/nl/docs/response/) 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](https://llmwebsearch.com/nl/docs/search/) 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/credits` is 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](https://llmwebsearch.com/nl/docs/errors/) somt elke status op en welke een nieuwe poging waard zijn.

## Waar ga ik hierna naartoe?

- [Search endpoint](https://llmwebsearch.com/nl/docs/search/) — Elke parameter van /search, met voorbeelden
- [Extract endpoint](https://llmwebsearch.com/nl/docs/extract/) — Lees 1 tot 20 URL's die je al hebt
- [Responseformaat](https://llmwebsearch.com/nl/docs/response/) — Elk veld en elke content_status
- [Fouten](https://llmwebsearch.com/nl/docs/errors/) — HTTP-fouten, paginastatussen, regels voor opnieuw proberen
- [Python](https://llmwebsearch.com/nl/docs/python/) — requests, async httpx, een antwoord met citaties
- [Node.js](https://llmwebsearch.com/nl/docs/node/) — fetch, een kleine pool, dezelfde citatielus
- [curl en jq](https://llmwebsearch.com/nl/docs/curl/) — Terminal-recepten
- [MCP server](https://llmwebsearch.com/nl/docs/mcp/) — search_web voor Claude Code en Claude Desktop
- [LangChain en LlamaIndex](https://llmwebsearch.com/nl/docs/langchain/) — Een tool en een retriever
- [OpenAI function calling](https://llmwebsearch.com/nl/docs/openai/) — Toolschema, loop en Agents SDK
- [n8n](https://llmwebsearch.com/nl/docs/n8n/) — HTTP Request-tool voor een AI Agent
- [OpenClaw](https://llmwebsearch.com/nl/docs/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.

---

LLMWebSearch: LLMWebSearch is een webzoek-API voor AI-agents die gerangschikte resultaten teruggeeft met de inhoud van de belangrijkste pagina's als Markdown, betaald met crypto zonder ID-upload. Voorafbetaalde credits vanaf US$ 1,20/1K zoekopdrachten verlopen nooit. Zonder KYC — geen ID, geen selfie, geen documenten. Betalen met crypto.