Docs · curl

Web search API için curl ve jq tarifleri

Q: API anahtarını URL'de geçirebilir miyim?

Evet, GET biçiminde -d api_key=… ile. Header daha güvenlidir, çünkü kabuk geçmişi ve proxy logları URL'leri kaydeder.

API'nin her özelliği bir terminalden çalışır. Bu tarifler API'yi çağırmak için curl ve JSON'u şekillendirmek için jq kullanır: bir sorguyu kodlamadan önce test etmek, shell betikleri ve cron job'ları için kullanışlıdır.

Son güncelleme: 22 Ekim 2026 · 3 dk okuma

Kısa yanıt

Komut satırından bir web search API'yi nasıl kullanırım?

https://llmwebsearch.com/api/v1/search adresine curl -d içeren bir JSON gövdesi gönderin, anahtarınızı Authorization: Bearer header'ında iletin ve yanıtı jq ile boru hattına aktarın. LLMWebSearch en iyi 3 sayfayı Markdown olarak içeren sıralı sonuçlar döndürür, böylece tek bir satırla kaynakları listeleyebilir veya sayfaları dosyalara kaydedebilirsiniz. Bir arama 1 kredi tutar; Ekim 2026 itibarıyla $1,20/1K arama'den başlar. KYC yok; kripto ile ödeme yapın.

Terminali bir kez nasıl kurarım?

Anahtarınızı shell'de export edin, böylece yazdığınız komutlardan ve geçmişinizden uzak kalır. Aşağıdaki tarifler onu $LLMWEBSEARCH_API_KEY olarak okur. Ayrıca, çoğu paket yöneticisinin bu adla kurduğu jq'e ihtiyacınız var.

Tüm tarifler bash veya zsh gibi bir POSIX shell varsayar. Windows'ta Git Bash veya WSL bunları değişiklik yapmadan çalıştırır.

Anahtarı ayarlayın ve bakiyenizi kontrol edin (ücretsiz)

export LLMWEBSEARCH_API_KEY="your-key"

curl -s "https://llmwebsearch.com/api/v1/credits" \
  -H "Authorization: Bearer $LLMWEBSEARCH_API_KEY" | jq .

Bir aramanın kaynaklarını nasıl listelerim?

Aramayı read değeri 0 olacak şekilde çalıştırın ve her sonuç için bir satır yazdırın: konum, host ve URL. Bu 1 kredi tutar ve bir sorunun hangi kaynakları ortaya çıkardığını bir saniyede gösterir. Bir agent sorguyu kullanmadan önce ifadesini ayarlamak için iyi bir yoldur.

Her sonuç için bir satır

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)"'

Okunan sayfaları nasıl kaydederim?

content_status değeri ok olan sonuçları tutun ve her content'yi kendi dosyasına yazın. Aşağıdaki tarif 01.md, 02.md ve devamını kaydeder; her biri kaynak URL'siyle başlar. jq sonuçları seçer ve shell döngüsü dosyaları yazar.

Her sayfayı Markdown olarak kaydedin

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 ./*.md

Birkaç siteden haberleri nasıl ararım?

Gövdeye topic, time_range ve include_domains ekleyin. Tarif, iki alan adındaki geçen haftanın haberlerini tutar ve her başlığın yanına tarihi yazdırır; bu, bir konuyu cron job'ından izlemek için yeterlidir.

İki alan adından geçen haftanın haberleri

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)"'

GET biçimini nasıl kullanırım?

Sorgu için curl -G'i --data-urlencode ile kullanın, böylece boşluklar ve simgeler sizin için kodlanır. include_domains gibi listeler virgülle ayrılmış tek bir değere dönüşür. GET hızlı bir test için kullanışlıdır; büyüyen betikler POST'a geçmelidir.

GET /search

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'

Elimde olan URL'leri nasıl okurum?

Bunları 1 ile 20 adres arasında bir JSON dizisi olarak /extract adresine gönderin. URL'sini zaten bildiğiniz sayfaları okumak, içerikle birlikte döndürülen her başlamış 3 sayfalık grup için 1 kredi eder, çağrı başına en fazla 20 URL; reddedilen veya başarısız olan URL'ler sayılmaz. Tarif her URL'yi durumu ve kelime sayısıyla yazdırır; bu, bir sitenin hangi sayfaları okumamıza izin verdiğini bir bakışta gösterir.

POST /extract

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)")'

Bir çağrı başarısız olduğunda hatayı nasıl görürüm?

HTTP durum kodunu -w ile yazdırın ve gövdeyi saklayın: hatalar code ve message içeren JSON olarak döner. Bir betik ardından durum koduna göre dallanabilir, örneğin yalnızca 429, 502 veya 504 durumlarında bekleyip yeniden deneyebilir. Bu hataların hiçbiri kredi kullanmaz.

Durum kodu ve hata gövdesi

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)"
fi

curl: sık sorulan sorular

JSON gövdem neden invalid_parameter ile başarısız oluyor?

Genellikle bir tırnak sorunudur. bash'te gövdeyi tek tırnak içine alın ki içindeki çift tırnaklar bozulmasın ve göndermeden önce echo '…' | jq . ile kontrol edin.

API anahtarını URL'de geçirebilir miyim?

Evet, GET biçiminde -d api_key=… ile. Header daha güvenlidir, çünkü kabuk geçmişi ve proxy logları URL'leri kaydeder.

Başarısız bir curl çağrısı kredi harcar mı?

Hayır. HTTP hataları hiçbir zaman kredi kullanmaz. Yalnızca sonuç döndüren bir arama ücretlendirilir, bunu credits_used gösterir.