Snel antwoord
Hoe gebruik ik een webzoek-API vanaf de commandoregel?
Stuur een JSON-body met curl -d naar https://llmwebsearch.com/api/v1/search, je API-sleutel in een Authorization: Bearer-header, en pipe het antwoord naar jq. LLMWebSearch geeft gerangschikte resultaten terug met de top 3 pagina's als Markdown, zodat één regel bronnen kan opsommen of pagina's naar bestanden kan opslaan. Een zoekopdracht kost 1 credit, vanaf US$ 1,20/1K zoekopdrachten per oktober 2026. Zonder KYC; betalen met crypto.
Hoe zet ik de terminal één keer op?
Exporteer je API-sleutel in de shell, zodat die buiten de commando's die je typt en buiten je history blijft. De recepten hieronder lezen hem als $LLMWEBSEARCH_API_KEY. Je hebt ook jq nodig, dat de meeste package managers onder die naam installeren.
Alle recepten gaan uit van een POSIX-shell zoals bash of zsh. Op Windows draaien Git Bash of WSL ze ongewijzigd.
export LLMWEBSEARCH_API_KEY="your-key"
curl -s "https://llmwebsearch.com/api/v1/credits" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" | jq .Hoe som ik de bronnen van een zoekopdracht op?
Voer de zoekopdracht uit met read op 0 en print één regel per resultaat: positie, host en URL. Dat kost 1 credit en laat je in een seconde zien welke bronnen een vraag oplevert. Het is een goede manier om de formulering van een zoekopdracht af te stemmen voordat een agent hem gebruikt.
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "postgres connection pool size", "max_results": 10, "read": 0}' \
| jq -r '.results[] | "\(.position)\t\(.host)\t\(.url)"'Hoe sla ik de pagina's op die gelezen zijn?
Houd de resultaten waarvan content_status gelijk is aan ok en schrijf elke content naar een eigen bestand. Het recept hieronder slaat 01.md, 02.md enzovoort op, elk beginnend met de bron-URL. jq selecteert de resultaten en de shell-loop schrijft de bestanden.
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "postgres connection pool size", "read": 3}' > search.json
jq -r '.results[] | select(.content_status == "ok") | .position' search.json | while read -r pos; do
jq -r --argjson p "$pos" '.results[] | select(.position == $p) | "Source: " + .url + "\n\n" + .content' \
search.json > "$(printf '%02d' "$pos").md"
done
ls -1 ./*.mdHoe zoek ik nieuws van een paar sites?
Voeg topic, time_range en include_domains toe aan de body. Het recept houdt nieuws van de afgelopen week op twee domeinen en print de datum naast elke titel, genoeg om een onderwerp vanuit een cron job in de gaten te houden.
curl -s "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "database security release", "topic": "news", "time_range": "week", "include_domains": ["news.example.com", "example.org"], "read": 0}' \
| jq -r '.results[] | "\(.published_at // "no date") \(.title) \(.url)"'Hoe gebruik ik de GET-vorm?
Gebruik curl -G met --data-urlencode voor de zoekopdracht, zodat spaties en symbolen voor je worden geëncodeerd. Lijsten zoals include_domains worden één kommagescheiden waarde. GET is handig voor een snelle test; scripts die groeien kunnen beter naar POST overstappen.
curl -sG "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
--data-urlencode "q=pgbouncer transaction mode" \
-d read=1 -d max_chars=3000 -d include_domains=example.com,example.org \
| jq -r '.results[0].content // .results[0].snippet'Hoe lees ik URL's die ik al heb?
Post ze naar /extract als een JSON-array van 1 tot 20 adressen. 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. Het recept print elke URL met zijn status en woordenaantal, wat in één oogopslag laat zien welke pagina's een site ons liet lezen.
curl -s "https://llmwebsearch.com/api/v1/extract" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://docs.example.com/security/key-rotation", "https://example.com/changelog"]}' \
| jq -r '"credits: \(.credits_used)", (.results[] | "\(.content_status)\t\(.word_count // 0)\t\(.url)")'Hoe zie ik de foutmelding wanneer een aanroep mislukt?
Print de HTTP-status met -w en bewaar de body: fouten komen terug als JSON met een code en een message. Een script kan dan op de status vertakken, bijvoorbeeld wachten en opnieuw proberen bij alleen 429, 502 of 504. Geen van deze fouten kost een credit.
status=$(curl -s -o body.json -w '%{http_code}' "https://llmwebsearch.com/api/v1/search" \
-H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q": "test query"}')
if [ "$status" != "200" ]; then
echo "HTTP $status: $(jq -r '.error.code + " - " + .error.message' body.json)"
ficurl: veelgestelde vragen
Waarom faalt mijn JSON-body met invalid_parameter?
Meestal een quoting-probleem. Zet de body in bash tussen enkele quotes, zodat de dubbele quotes binnenin intact blijven, en controleer hem met echo '…' | jq . voordat je hem verstuurt.
Kan ik de sleutel in de URL meegeven?
Ja, met -d api_key=… op de GET-vorm. De header is veiliger, omdat shell-history en proxylogs URL's vastleggen.
Kost een mislukte curl-aanroep een credit?
Nee. HTTP-fouten kosten nooit credits. Alleen een zoekopdracht die resultaten oplevert, wordt gefactureerd, zoals credits_used laat zien.