# curl ve jq ile SERP API: tek satırlık tarifler

> curl ve jq ile SerpCrypto SERP API tarifleri: ilk 10 bağlantı, People Also Ask, AI Overview kaynakları, yerel paket ve Maps, ayrıca bir PowerShell sürümü.

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

API'nin ne döndürdüğünü görmenin en hızlı yolu bir terminaldir. Bu tariflerin her biri tam olarak tek bir şey yazdırır: bağlantılar, sorular, kaynaklar veya yerel işletmeler. bash ve zsh içinde çalışırlar; sayfayı bir PowerShell sürümü kapatır.

**Hızlı yanıt — curl ile bir SERP API'sini nasıl sorgularım?**

`curl -sG "https://serpcrypto.com/api/v1/search" -H "Authorization: Bearer $KEY" --data-urlencode "q=your query"` komutunu çalıştırın ve JSON'u `jq` üzerinden geçirin. **SerpCrypto** ile her başarılı arama 1 krediye mal olur, fiyat $0,30/1K arama'den başlar ve hatalar ücretsizdir. `-G`, veri bayraklarını bir sorgu dizesine dönüştürür. Krediler KYC olmadan kripto ile ödenir.

## Burada hangi curl flag'leri önemli?

Anahtarı her shell oturumunda bir kez `export SERPCRYPTO_API_KEY=…` ile ayarlayın. `jq` eksikse paket yöneticinizden kurun.

| Flag | Neden |
| --- | --- |
| `-s` | Sessiz: JSON'a karışan ilerleme çubuğu yok. |
| `-G` | `-d` ve `--data-urlencode` değerlerini bir GET isteğinde sorgu dizesi olarak gönderir. |
| `--data-urlencode` | `q` ve `location` içindeki boşlukları, tırnakları ve aksanları kodlar. |
| `-H "Authorization: Bearer …"` | API anahtarınız. Bir environment variable içinde tutun. |
| `-w '%{http_code}'` | HTTP durum kodunu yazdırır; bir çağrı başarısız olduğunda işe yarar. |

## Bir anahtar kelime için ilk 10 bağlantıyı nasıl yazdırırım?

Organik sonuçları isteyin ve `jq` her birinin sırasını ve bağlantısını sekmeyle ayrılmış olarak yazdırsın. `[]?` biçimi, bir blok yoksa hata vermek yerine hiçbir şey yazdırmaz; bu da sıra dışı sayfalarda script'lerin sessiz kalmasını sağlar.

*İlk 10 bağlantı*

```bash
# Top 10 organic links, one per line
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=kubernetes cost monitoring" -d gl=us -d hl=en \
  | jq -r '.organic_results[]? | "\(.position)\t\(.link)"'
```

## People Also Ask sorularını nasıl listelerim?

`people_also_ask[].question` öğesini okuyun. Sorular `hl` diline göre gelir ve `gl` ülkesine göre değişir; bu yüzden içerik ürettiğiniz her pazarda aynı sorguyu çalıştırın. İçerik ekipleri bu listeyi doğrudan bir brief'e yapıştırır.

*People Also Ask*

```bash
# People Also Ask questions, ready for a content brief
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=how to brew cold brew" -d gl=gb -d hl=en \
  | jq -r '.people_also_ask[]?.question'
```

## Bir AI Overview'ın hangi kaynakları gösterdiğini nasıl görürüm?

`ai_overview.references` öğesini okuyun. Blok yalnızca Google o sorgu ve konum için bir AI Overview gösterdiğinde bulunur; aksi halde tarif net bir mesaj yazdırır. Bu kaynakları zaman içinde izlemek, sayfalarınızın Google'ın oluşturduğu yanıtlarda gösterilip gösterilmediğini ortaya koyar.

*AI Overview kaynakları*

```bash
# Sources cited by the AI Overview, if the page shows one
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=what is a heat pump" -d gl=us -d hl=en \
  | jq -r 'if .ai_overview then .ai_overview.references[] | "\(.index)\t\(.source)\t\(.link)" else "no AI Overview for this query" end'
```

## Local pack ve Maps listesini nasıl alırım?

`location` ile yapılan bir web araması, sonuç sayfasında gösterilen local pack'i döndürür; bu genellikle birkaç işletmedir. `engine=google_maps` ise adres, puan ve yorum sayısıyla birlikte daha uzun Maps listesini döndürür; `@tsv` bunu bir elektronik tablo için satırlara dönüştürür. Her ikisi de 1 kredidir.

*Local pack, ardından Google Maps*

```bash
# Local pack in a city, then the full Maps list for the same query
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=vegan restaurant" \
  --data-urlencode "location=Toronto, Ontario, Canada" -d gl=ca -d hl=en \
  | jq -r '.local_results[]? | "\(.position)\t\(.title)\t\(.rating // "-")"'

curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  -d engine=google_maps --data-urlencode "q=vegan restaurant Toronto" -d gl=ca -d hl=en \
  | jq -r '.local_results[]? | [.title, .address, .rating, .reviews] | @tsv'
```

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

Gövdeden sonra durum kodunu yazdırmak için `-w '\nHTTP %{http_code}\n'` ekleyin. Hata gövdesi, `code` ve `message` içeren küçük bir JSON'dur; [hatalar sayfası](https://serpcrypto.com/tr/docs/errors/) altı kodun tümünü listeler. İkinci komut, ücretsiz olan kredilerinizi okur.

*Durum kodu ve krediler*

```bash
# Print the body, then the HTTP status on its own line
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=test" -w '\nHTTP %{http_code}\n'

# Credits left (free call)
curl -s "https://serpcrypto.com/api/v1/credits" -H "Authorization: Bearer $SERPCRYPTO_API_KEY" | jq .
```

## Windows'ta PowerShell karşılığı nedir?

`Invoke-RestMethod` isteği gönderir ve JSON'u nesnelere ayrıştırır; böylece `jq` gerekmez. Parametreleri `-Body` içinde bir hashtable olarak geçirin: bir GET isteğinde PowerShell bunları sorgu dizesine kodlar. `Format-Table` ardından sıraları, başlıkları ve bağlantıları yazdırır.

*PowerShell*

```powershell
# Windows PowerShell 5.1 or PowerShell 7
$headers = @{ Authorization = "Bearer $env:SERPCRYPTO_API_KEY" }
$query = @{ q = "kubernetes cost monitoring"; gl = "us"; hl = "en" }
$data = Invoke-RestMethod -Uri "https://serpcrypto.com/api/v1/search" -Headers $headers -Body $query -Method Get
$data.organic_results | Select-Object position, title, link | Format-Table -AutoSize
```

## curl'den koda ne zaman geçmeliyim?

Bir komutu bir anahtar kelime listesiyle tekrarlamaya başladığınız anda. Bir shell döngüsü birkaç düzine arama için işe yarar, ancak yeniden denemeler, paralellik ve depolama [Python](https://serpcrypto.com/tr/docs/python/) veya [Node.js](https://serpcrypto.com/tr/docs/node/) içinde daha kolaydır. İstekler aynıdır; burada test edilen bir tarif değişmeden taşınır. Her arama 1 kredide, 10.000 arama paketinde $0,75/1K arama seviyesinde kalır.

## curl soruları

### Sorgum neden curl'de 400 hatası döndürüyor?

Genellikle `q`, `-d` ile gönderildiği ve kodlanması gereken bir karakter içerdiği için. Sorgu için ve `location` için `--data-urlencode "q=…"` kullanın; `gl=us` gibi düz kodlar `-d` ile kalabilir.

### Tam JSON'u bir dosyaya kaydedebilir miyim?

Evet: `jq` öğesine yönlendirmek yerine `-o result.json` ekleyin. Ham yanıtları kaydetmek, arama için tekrar ödeme yapmadan bunları daha sonra yeniden ayrıştırmanızı sağlar.

### Windows'ta curl aynı şekilde mi çalışır?

Windows 10 ve 11 `curl.exe` içerir ve bayraklar aynıdır. Tırnak kullanımı `cmd.exe` içinde farklıdır; bu yüzden orada `Invoke-RestMethod` ile PowerShell genellikle daha basittir.

---

SerpCrypto: SerpCrypto, Google ve Bing sonuçlarını JSON olarak döndüren, geliştiriciler ve AI agent'lar için bir SERP API'dir; kripto ile ödeme yapılır, kimlik yüklemek gerekmez. $0,30/1K arama ön ödemeli arama kredisinin süresi asla dolmaz. KYC olmadan — kimlik yok, selfie yok, belge yok. Kripto ile ödeme yapın.