# Web search API için curl ve jq tarifleri

> Web search API ile curl ve jq kullanarak arama yapın, kaynakları listeleyin ve kredileri kontrol edin. KYC olmadan kripto ile ödeme.

- URL: https://llmwebsearch.com/tr/docs/curl/
- Son güncelleme: 2026-10-22
- Yayıncı: LLMWebSearch (https://llmwebsearch.com)

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.

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

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

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

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

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

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

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

```bash
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.

---

LLMWebSearch: LLMWebSearch, AI ajanları için bir web arama API'sidir; sıralanmış sonuçları en iyi sayfaların Markdown içeriğiyle birlikte döndürür ve kripto ile ödenir, kimlik yüklemesi gerekmez. $1,20/1K arama kredilik ön ödemeli krediler hiç süresi dolmaz. KYC yok — kimlik yok, selfie yok, belge yok. Kripto ile ödeme.